> ## Documentation Index > Fetch the complete documentation index at: https://docs.trio.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Get Counterparty > Show a counterparty ## OpenAPI ````yaml v2/api-reference/openapi.json GET /v2/counterparties/{id} openapi: 3.0.0 info: title: Trio API v2 version: 2026-10-19.v2 servers: - url: https://api.sandbox.trio.com.br variables: {} - url: https://api.qa.trio.com.br variables: {} - url: https://api.trio.com.br variables: {} security: [] tags: [] paths: /v2/counterparties/{id}: parameters: - description: >- Version of the v2 contract the client is written against. Each breaking change publishes a new version. example: 2026-10-19.v2 in: header name: Trio-Version required: true schema: enum: - 2026-10-19.v2 type: string x-struct: null x-validate: null - description: >- ID of another org to act on instead of the API key's own org. The key's org must have been granted access to it, and the request is refused with 403 FORBIDDEN otherwise. When that access or the API key is read-only, only GET and HEAD requests may carry it. When the target org requires mTLS, so does the request. Leave it out to act on the key's own org. in: header name: Trio-Target-Org-Id required: false schema: format: uuid type: string x-struct: null x-validate: null get: tags: - Counterparties summary: Show counterparty description: Show a counterparty operationId: TrioFoundationWeb.V2.CounterpartyController.show parameters: - description: Counterparty ID in: path name: id required: true schema: $ref: '#/components/schemas/UUID' responses: '200': content: application/json: schema: $ref: '#/components/schemas/V2_counterparty_response' description: Counterparty '400': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: >- Malformed request: a body that is not valid JSON (MALFORMED_REQUEST), or a Trio-Version header that is missing or not the current one (INVALID_TRIO_VERSION). '401': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: Missing or invalid API key credentials (INVALID_CREDENTIALS). '403': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: >- The API key may not do this (FORBIDDEN): for instance Trio-Target-Org-Id names an org it has no access to, or writes through a read-only access. '404': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: No resource with this ID (NOT_FOUND_RESOURCE). '422': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: >- Invalid input (INVALID_PARAMETER, REQUIRED_PARAMETER, or the code of the rule the request breaks). A request outside the operation's schema lists the offending fields in `errors`. '503': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: >- A service needed to answer is unavailable (TRIO_SERVICE_UNAVAILABLE). callbacks: {} security: - authorization: [] components: schemas: UUID: description: Unique identifier format: uuid title: UUID type: string x-struct: null x-validate: null V2_counterparty_response: description: Counterparty response example: data: bank_accounts: - branch: '0001' digit: '1' id: 018df099-093e-cfd1-4500-4c9392eb5d8a inserted_at: '2024-10-17T13:32:59.374149Z' ispb: '12345678' number: '87654321' type: checking updated_at: '2024-10-17T13:32:59.374149Z' id: 018df099-093e-cfd1-4500-4c9392eb5d8a inserted_at: '2024-10-17T13:32:59.374149Z' name: participant_1 tax_number: '***456789**' updated_at: '2024-10-17T13:32:59.374149Z' properties: data: $ref: '#/components/schemas/V2_counterparty' title: V2 counterparty response type: object x-struct: Elixir.TrioFoundationWeb.Schemas.Banking.V2.Counterparty.Response x-validate: null V2_error: example: error: error_code: INVALID_PARAMETER error_message: 'Invalid parameters: /amount: Invalid integer. Got: string' errors: - field: /amount message: 'Invalid integer. Got: string' properties: error: properties: error_code: description: >- Stable UPPER_SNAKE identifier of the error, for programs and logs. Branch on this, not on the message. type: string x-struct: null x-validate: null error_message: description: Human readable explanation of the error. type: string x-struct: null x-validate: null errors: description: >- Only on INVALID_PARAMETER for a request outside the operation's schema: one entry per offending field. items: properties: field: description: JSON pointer to the field, e.g. /amount. type: string x-struct: null x-validate: null message: description: What is wrong with it. type: string x-struct: null x-validate: null required: - field - message type: object x-struct: null x-validate: null type: array x-struct: null x-validate: null required: - error_code - error_message type: object x-struct: null x-validate: null required: - error title: V2 error type: object x-struct: Elixir.TrioFoundationWeb.Schemas.HTTP.V2Error x-validate: null V2_counterparty: description: A counterparty and its bank accounts example: bank_accounts: - branch: '0001' digit: '1' id: 018df099-093e-cfd1-4500-4c9392eb5d8a inserted_at: '2024-10-17T13:32:59.374149Z' ispb: '12345678' number: '87654321' type: checking updated_at: '2024-10-17T13:32:59.374149Z' id: 018df099-093e-cfd1-4500-4c9392eb5d8a inserted_at: '2024-10-17T13:32:59.374149Z' name: participant_1 tax_number: '***456789**' updated_at: '2024-10-17T13:32:59.374149Z' properties: bank_accounts: items: $ref: '#/components/schemas/V2_counterparty_bank_account' type: array x-struct: null x-validate: null id: description: ID format: uuid type: string x-struct: null x-validate: null inserted_at: description: Creation date and time format: date-time type: string x-struct: null x-validate: null name: description: Name of the counterparty type: string x-struct: null x-validate: null tax_number: description: >- Tax number of the counterparty. A CPF is masked (e.g. ***456789**); a CNPJ is published as is type: string x-struct: null x-validate: null updated_at: description: Last update date and time format: date-time type: string x-struct: null x-validate: null title: V2 counterparty type: object x-struct: >- Elixir.TrioFoundationWeb.Schemas.Banking.V2.Counterparty.CounterpartyData x-validate: null V2_counterparty_bank_account: description: A counterparty bank account example: branch: '0001' digit: '1' id: 018df099-093e-cfd1-4500-4c9392eb5d8a inserted_at: '2024-10-17T13:32:59.374149Z' ispb: '12345678' number: '87654321' type: checking updated_at: '2024-10-17T13:32:59.374149Z' properties: branch: description: Branch type: string x-struct: null x-validate: null digit: description: Account digit type: string x-struct: null x-validate: null id: description: Counterparty bank account ID format: uuid type: string x-struct: null x-validate: null inserted_at: description: >- Creation date and time. Null on show for a while after the bank account was found or created, which caches it without its dates format: date-time nullable: true type: string x-struct: null x-validate: null ispb: description: ISPB of the institution type: string x-struct: null x-validate: null number: description: Account number type: string x-struct: null x-validate: null type: description: Account type enum: - checking - payment - salary - savings type: string x-struct: null x-validate: null updated_at: description: >- Last update date and time. Null on show for a while after the bank account was found or created, which caches it without its dates format: date-time nullable: true type: string x-struct: null x-validate: null title: V2 counterparty bank account type: object x-struct: >- Elixir.TrioFoundationWeb.Schemas.Banking.V2.Counterparty.BankAccount.BankAccountData x-validate: null securitySchemes: authorization: scheme: basic type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.