Create a Counterparty

POST

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

This API allows the creation of counterparties.

See Managing Counterparties guide

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

Examples

Responses

🟢201Creado

application/json

Example response

Body

🟠409Conflicto

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.cobre.co/v1/counterparties' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "geo": "col",
    "type": "ch",
    "alias": "Cobre'\''s main account",
    "metadata": {
        "account_number": "1013555555",
        "beneficiary_institution": "1007",
        "counterparty_fullname": "Fernando Alonso Díaz",
        "counterparty_id_number": "5334623427",
        "counterparty_id_type": "cc",
        "counterparty_phone": "+18800347411",
        "counterparty_email": "fernando.alonso@cobre.co"
    }
}'

Response Example

201 - ch

{
    "id": "cp_AWgvElV9js",
    "geo": "col",
    "type": "cc",
    "alias": "Cobre's main account",
    "metadata": {
        "registered_account": "false",
        "account_number": "1013555555",
        "counterparty_id_type": "cc",
        "counterparty_email": "fernando.alonso@cobre.co",
        "counterparty_phone": "+18800347411",
        "beneficiary_institution": "1007",
        "counterparty_id_number": "5334623427",
        "counterparty_fullname": "Fernando Alonso Díaz"
    },
    "created_at": "2025-12-01T05:36:45Z",
    "updated_at": "2025-12-01T05:36:45Z"
}

Modified at 2026-01-06 00:56:32

Obtain one Registration

Obtain one Counterparty