Obtain all Counterparties

GET

https://api.cobre.co/v1/counterparties

This endpoint retrieve all counterparties.

Privacy Features

To ensure the utmost protection of confidential data, the API is equipped with functionality to obscure any sensitive information within the counterparty details. By leveraging the sensitive_data parameters, you have the flexibility to customize the API's response format to suit your specific requirements, ensuring that sensitive information details are presented in a secure manner.

This feature not only provides peace of mind regarding data security but also allows for tailored information retrieval, making it easier than ever to manage counterparty information safely and efficiently.

See Managing Counterparties guide

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200Correcto

application/json

Example response

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.cobre.co/v1/counterparties?page_number&sensitive_data&alias&counterparty_full_name&type&counterparty_id_number&account_number&counterparty_email&registered_account&beneficiary_institution&created_at&created_gte&created_lte' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "total_items": 1,
    "total_pages": 1,
    "is_last_page": false,
    "page_items": 50,
    "contents": [
        {
            "id": "cp_NBJCEY7UXn",
            "geo": "col",
            "type": "cc",
            "alias": "Cobre's main account",
            "metadata": {
                "account_number": "023550031",
                "beneficiary_institution": "1023",
                "counterparty_email": "fernando.alonso@cobre.co",
                "counterparty_fullname": "Fernando Alonso Díaz",
                "counterparty_id_number": "5334623427",
                "counterparty_id_type": "cc",
                "counterparty_phone": "+18800347411",
                "registered_account": "false"
            },
            "created_at": "2025-12-01T05:38:54Z",
            "updated_at": "2025-12-01T05:38:54Z"
        }
    ]
}

Modified at 2026-01-06 03:40:06

Obtain one Counterparty

Delete a Counterparty

Obtain all Counterparties

Privacy Features#

Request

Responses

Privacy Features