# BBAN Company Search

Gets search for bankmatch BBAN company matching

Endpoint: GET /compliance/bankMatch/BBAN/company
Version: 1.10.9
Security: bearerToken

## Query parameters:

  - `country` (string, required)
    An ISO Alpha-2 country code of the company

  - `language` (string)
    The language code to specify the desired language of the response. Please use the  endpoint to confirm available languages.   If unsupported language is passed, the system defaults to English ().

  - `bankCountry` (string, required)
    An ISO Alpha-2 country code used to specify the country for company bank matching criteria

  - `regNo` (string)
    Registration number of the company for bank matching criteria

  - `bban` (string)
    Basic Bank Account Number (BBAN) for bank matching criteria

  - `bic` (string)
    Bank Identifier Code (BIC) for BBAN company matching

  - `routingCode` (string)
    Routing code for BBAN company matching

## Response 200 fields (application/json):

  - `id` (string)
    Unique identifier for the bank match search.

  - `classification` (string)
    Classification result of the search (e.g., 'NO').

  - `status` (string)
    Status of the search process (e.g., 'SUCCEEDED').

  - `entity` (object)
    Contains details about the entity associated with the BBAN.

  - `entity.paymentIdentity` (object)

  - `entity.paymentIdentity.id` (string)
    The payment identity ID.

  - `entity.paymentIdentity.iban` (string)
    International Bank Account Number (IBAN).

  - `entity.paymentIdentity.bic` (string)
    Bank Identifier Code (BIC).

  - `entity.paymentIdentity.countryCode` (string)
    Country code of the bank account.

  - `entity.paymentIdentity.bban` (string)
    Basic Bank Account Number (BBAN).

  - `entity.paymentIdentity.routingCode` (string)
    Routing code for the bank account.

  - `entity.paymentIdentity.type` (string)
    Type of payment identity (e.g., 'BBAN').

  - `entity.company` (object)

  - `entity.company.registrationId` (string)
    Registration ID of the company.

  - `entity.company.name` (string)
    Name of the company.

  - `entity.company.legalPerson` (boolean)
    Indicates if the entity is a legal person.

  - `entity.company.typeId` (string)
    Type identifier of the company.

  - `entity.company.countryCode` (string)
    Country code of the company.

  - `entity.company.status` (string)
    Status of the company.

  - `input` (object)
    Input details used for the search.

  - `input.paymentIdentity` (object)
    Payment identity details provided in the input.

  - `input.paymentIdentity.bic` (string)
    BIC provided in the input.

  - `input.paymentIdentity.bban` (string)
    BBAN provided in the input.

  - `input.paymentIdentity.routingCode` (string)
    Routing code provided in the input.

  - `input.company` (object)
    Company details provided in the input.

  - `input.company.registrationId` (string)
    Registration ID of the input company.

  - `input.company.countryCode` (string)
    Country code of the input company.

  - `reasons` (array)
    List of reason codes for the result.

  - `sepamailVerificationStatus` (string)
    Status of the SepaMail verification.

  - `reasonLabels` (object)
    Labels describing the reasons for the result.

## Response 202 fields (application/json):

  - `correlationId` (string)
    Example: "78ba8a1a-a614-4d7a-bcc3-ea682cd6b510"

  - `checkId` (string)
    Example: "6889c5ef89750f4fc83226cd"

  - `message` (string)
    Example: "The company details are currently being verified. You can track the progress of this request on the /localSolutions/FR/bankmatch/audition?audition_id={audition_id} endpoint."

## Response 400 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected

## Response 401 fields (application/json):

  - `error` (string)

## Response 403 fields (application/json):

  - `message` (string)
    Example: "Access forbidden"

## Response 404 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected

## Response 409 fields (application/json):

  - `correlationId` (string)
    The unique identifier. (A UUID specified by RFC4122).

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected

## Response 502 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected