---
title: "Retrieve verification scheme participant"
method: GET
path: "/verification_scheme_participants/{participant_bic}"
tags: ["verification-scheme-participants"]
---

# Retrieve verification scheme participant

`GET /verification_scheme_participants/{participant_bic}`

## Request

- Base URL: `https://sandbox.numeral.io/v1`
- URL: `https://sandbox.numeral.io/v1/verification_scheme_participants/{participant_bic}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/numeral/apis/payments/docs/verification_scheme_participants/:participant_bic/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the details of a verification scheme participant.

## Path parameters

- `participant_bic` string, required

## Response `200`

Successfully retrieved verification scheme participant

- VerificationSchemeParticipantDetails: Details of a verification scheme participant.
  - `participant_bic` string, required: The BIC of the participant.
  - `participant_name` string, required: The name of the participant.
  - `country_code` string, required: The country code of the participant.
  - `psd2_nans` string[], required: PSD2 National Authorization Numbers of the participant.
  - `operational_contacts` VerificationSchemeParticipantOperationalContact[], required: Operational contacts of the participant.
    - `email` string, required: Email address of the operational contact.
  - `schemes` VerificationSchemeParticipantScheme[], required: Schemes the participant is part of.
    - `code` string, required: Code of the verification scheme.
    - `uris` VerificationSchemeParticipantSchemeUri[], required: List of API URIs for this scheme.
      - `environment` 'L' | 'T', required: Environment indicator (L for Live, T for Test).
      - `operation` string, required: API operation identifier.
      - `api_uri` string, required: URI of the API endpoint.
      - `api_version` integer, required: Version of the API.
      - `priority_number` integer, required: Priority of this URI (lower number means higher priority).
      - `account_holding_bics` string[], required: List of BICs for which this URI is valid.
      - `start_date_time` string, date-time, required: Start date and time from which this URI is valid.
      - `end_date_time` string, date-time: End date and time until which this URI is valid.
      - `note` string: Additional notes about this URI.
    - `roles` VerificationSchemeParticipantSchemeRole[], required: Roles of the participant in this scheme.
      - `code` string, required: Code representing the role in the scheme.
    - `options` VerificationSchemeParticipantSchemeOption[], required: Options supported by the participant in this scheme.
      - `code` string, required: Option code.
      - `readiness_date` string, date, required: Date from which the option is ready to be used.
      - `leaving_date` string, date: Date until which the option is available.
    - `readiness_date` string, date, required: Date from which the participant is ready to operate in this scheme.
    - `leaving_date` string, date: Date until which the participant is part of this scheme.

## Other responses

- `400`: Validation error.
- `404`: The specified resource was not found.
- `500`: Internal server error.

---

[API](https://skmtc.dev/numeral/apis/payments.md) - [All operations](https://skmtc.dev/numeral/apis/payments/llms.txt) - [OpenAPI document](https://skmtc.dev/numeral/apis/payments/revisions/220f101cc2ef?raw)