v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

International

Get International Searches

Retrieve a list of international business searches.

get/international/searches

Query parameters

qstring nullable

The query param, can either be a search name or a search id. If it is a search id, it will be used to search by id. If it is a search name, it will be used to search by name. If it is not provided, it will be ignored.

limitinteger

Maximum number of records to return in a single page. Must be between 1 and 1000.

offsetinteger nullable

Number of records to skip from the beginning. Use 0 for the first page. Cannot be used with cursor.

cursorstring nullable

Opaque pagination cursor token that identifies the position in the result set. Use the cursor from the previous response to get the next page. Cannot be used with offset.

start_datestring date nullable

Filter records created on or after this date (format: YYYY-MM-DD).

end_datestring date nullable

Filter records created on or before this date (format: YYYY-MM-DD).

tzstring

IANA timezone identifier used to interpret start_date and end_date (defaults to UTC).

Example:UTC

IANA timezone identifier used to interpret start_date and end_date (defaults to UTC).

Response

List of international business searches.

idstring uuid required

Unique identifier for the international business search.

state'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' required

namestring nullable

The name inputted in the search (null for filing-number-only searches).

addressstring nullable

The address string inputted in the search (null for filing-number-only searches).

iso2_country_code'AR' | 'AU' | 'AT' | 'BE' | 'BR' | 'CA' | 'CZ' | 'DK' | 'FI' | 'FR' | 'DE' | 'IN' | 'IE' | 'IT' | 'JP' | 'KE' | 'LU' | 'MY' | 'MX' | 'NL' | 'NZ' | 'NG' | 'NO' | 'PL' | 'PT' | 'SA' | 'SK' | 'ES' | 'SE' | 'CH' | 'TR' | 'UA' | 'GB'

Enumeration of ISO 3166-1 alpha-2 country codes supported for international searches.

This is a subset of ISO2CountryCode that includes only jurisdictions where international search capabilities are available.

filing_numberstring nullable

The company registration (filing) number inputted in the search.

reference_idstring nullable

The reference ID inputted in the search.

business_name_match'NO_MATCH' | 'SIMILAR' | 'EXACT'

business_address_match'NO_MATCH' | 'REGION' | 'CITY' | 'COUNTRY' | 'EXACT'

filing_number_matchboolean nullable

Whether the inputted filing number found the company at the registry. False means the search fell back to the name search; null means no filing number was provided.

created_atstring date-time required

The datetime the search was created.

updated_atstring date-time nullable

The datetime the search was updated at (generally when the search completed).

verifiedboolean nullable

Indicates whether the found business was a close enough match to be considered verified.

errorstring nullable

Any errors that occurred.

warningsstring[]

Any warnings that occurred.

optionsInternationalBusinessSearchOptions[]

Optional, separately-billed add-ons requested for this search.

urlstring uri required

The API URL to retrieve the search.

Example response

[
  {
    "user": {
      "first_name": "Austin",
      "last_name": "Taylor",
      "email": "jessicasimpson@example.com"
    },
    "name": "Acme Corporation",
    "address": "1640 Riverside Drive, Hill Valley, CA",
    "search_address": {
      "premise": "221B",
      "thoroughfare": "Baker Street",
      "dependent_thoroughfare": "Marylebone Road",
      "locality": "London",
      "dependent_locality": "Westminster",
      "administrative_area": "England",
      "postal_code": "NW1 6XE",
      "country_iso_3": "GBR",
      "latitude": 51.5237,
      "longitude": -0.1585,
      "type": "Registered Office"
    },
    "filing_number": "09517735",
    "reference_id": "Search1234",
    "filing_number_match": true,
    "created_at": "2026-07-16T19:24:27.811868",
    "updated_at": "2026-07-16T19:24:27.811885",
    "verified": true,
    "scores": [
      {
        "score": 95,
        "rating": "A"
      }
    ],
    "options": [
      "Order.Enhanced"
    ],
    "business": {
      "name": "Acme Corporation",
      "file_number": "867124",
      "standing": "Registered",
      "legal_form": "ltd",
      "issue_date": "2024-01-01",
      "incorporation_date": "2024-01-01",
      "last_annual_account_date": "2024-01-01",
      "dissolution_date": "2024-01-01",
      "registration_authority": "Companies House, United Kingdom",
      "registration_authority_code": "CA-ON",
      "registration_type": "Federal",
      "registry_type": "Registered society",
      "addresses": [
        {
          "premise": "221B",
          "thoroughfare": "Baker Street",
          "dependent_thoroughfare": "Marylebone Road",
          "locality": "London",
          "dependent_locality": "Westminster",
          "administrative_area": "England",
          "postal_code": "NW1 6XE",
          "country_iso_3": "GBR",
          "latitude": 51.5237,
          "longitude": -0.1585,
          "type": "Registered Office"
        }
      ],
      "alternative_names": [
        "Ramos, Garcia and Good"
      ]
    },
    "url": "https://api.baselayer.com/searches/c623e29e-1f57-11ef-938f-1edb1b067314"
  }
]