> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baselayer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search International Registrations

> List registry registrations matching a business name or filing number.
You must provide one of `name` or `filing_number`.

With an `iso2_country_code`, a search will be performed directly at the registry for that jurisdiction.
Without an `iso2_country_code`, a global search will be performed across all jurisdictions.

Pass a result's `filing_number` (with the country) to
`POST /international/searches` to run a lite or enhanced search for
exactly that company, skipping name/address matching.



## OpenAPI

````yaml /api-reference/openapi.json get /international/registrations
openapi: 3.1.0
info:
  title: baselayer-api-service
  version: 0.1.0
servers:
  - url: https://api.baselayer.com/
security: []
paths:
  /international/registrations:
    get:
      tags:
        - International
      summary: Search International Registrations
      description: >-
        List registry registrations matching a business name or filing number.

        You must provide one of `name` or `filing_number`.


        With an `iso2_country_code`, a search will be performed directly at the
        registry for that jurisdiction.

        Without an `iso2_country_code`, a global search will be performed across
        all jurisdictions.


        Pass a result's `filing_number` (with the country) to

        `POST /international/searches` to run a lite or enhanced search for

        exactly that company, skipping name/address matching.
      operationId: search_international_registrations_international_registrations_get
      parameters:
        - name: iso2_country_code
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Jurisdiction code in ISO 3166 alpha-2
            examples:
              - GB
            title: Iso2 Country Code
          description: Jurisdiction code in ISO 3166 alpha-2
        - name: name
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Company Name
            examples:
              - Kyckr
            title: Name
          description: Company Name
        - name: filing_number
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Company registration (filing) number
            examples:
              - '11655290'
            title: Filing Number
          description: Company registration (filing) number
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/v1.InternationalRegistrationResponse'
                title: >-
                  Response Search International Registrations International
                  Registrations Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    v1.InternationalRegistrationResponse:
      properties:
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
          description: The registered name of the business.
          examples:
            - KYCKR UK LIMITED
        alternative_names:
          items:
            type: string
          type: array
          title: Alternative Names
          description: >-
            A list of alternative names (e.g. trading names and former
            registered names) the registry holds for the business.
          examples:
            - - Ramos, Garcia and Good
        filing_number:
          anyOf:
            - type: string
            - type: 'null'
          title: Filing Number
          description: >-
            The registry filing number. Pass it as `filing_number` to `POST
            /international/searches` to search exactly this company.
          examples:
            - '11655290'
        address:
          anyOf:
            - type: string
            - type: 'null'
          title: Address
          description: The business's address as held by the registry.
          examples:
            - Kemp House, 160 City Road, London, United Kingdom, EC1V 2NX
        standing:
          anyOf:
            - type: string
            - type: 'null'
          title: Standing
          description: >-
            The registry's own status wording (e.g. 'Active', 'Registered', 'In
            Liquidation').
          examples:
            - Active
        legal_form:
          anyOf:
            - type: string
            - type: 'null'
          title: Legal Form
          description: The registry's legal form / legal structure for the business.
          examples:
            - Private limited company
        registry_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Registry Type
          description: >-
            Registry-provided entity or registry type where distinct from legal
            form.
          examples:
            - Registered society
        registration_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Registration Type
          description: >-
            Registry-provided registration type, e.g. Federal, Extra-Provincial,
            or Registered society.
          examples:
            - Federal
        incorporation_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Incorporation Date
          description: The date the business was incorporated or registered.
          examples:
            - '2018-11-01'
        registration_authority:
          anyOf:
            - type: string
            - type: 'null'
          title: Registration Authority
          description: Registry authority name, e.g. Companies House, United Kingdom.
          examples:
            - Companies House, United Kingdom
        registration_authority_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Registration Authority Code
          description: Registry authority code where provided, e.g. CA-ON or CA-FE.
          examples:
            - CA-ON
      type: object
      title: InternationalRegistrationResponse (v1)
      description: |-
        A business's registration (filing) at an international registry.

        A raw registry match from ``GET /international/registrations`` — not a
        record in our system. The fields speak the same vocabulary as the
        ``business`` an international search returns (`InternationalBusiness`);
        pass a result's `filing_number` (with the country) to
        ``POST /international/searches`` to run a lite or enhanced search for
        exactly this company.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````