# Banks

{% columns fullWidth="true" %}
{% column %}
Banks represent the financial institutions available for a given country in the Conomy network.

Use the Banks API to retrieve the list of supported banks by country code. This is useful when building payment flows that require the payer to select their bank, such as PSE or local bank transfer methods.
{% endcolumn %}

{% column %}
{% code title="Endpoints" overflow="wrap" %}

```http
GET /payments/banks/:country
```

{% endcode %}
{% endcolumn %}
{% endcolumns %}

## List banks by country

> Returns all supported banks and financial institutions for the given country code. Use the \`code\` value as the \`bank\` field in \`BANK\_ACCOUNT\`, \`BREB\`, or \`SPEI\` payment nodes.

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Payment-methods"}],"security":[{"BearerToken":[]}],"components":{"securitySchemes":{"BearerToken":{"type":"http","scheme":"bearer"}},"schemas":{"bank":{"type":"object","description":"A financial institution supported by conomy for a given country.","properties":{"code":{"type":"string","description":"Bank code used in payment nodes (e.g., `BANCO_CHILE`, `co_bancolombia`)."},"name":{"type":"string","description":"Human-readable bank name."},"countryCode":{"type":"string","description":"ISO country code of the bank (e.g., `CHL`, `COL`)."}},"required":["code","name","countryCode"],"title":"bank"},"error":{"type":"object","description":"Standard error response payload.","properties":{"statusCode":{"type":"integer","description":"HTTP status code."},"error":{"type":"string","description":"Error category."},"message":{"type":"string","description":"Human-readable error message."}},"required":["statusCode","error","message"]}},"responses":{"Bad request":{"description":"The request is invalid, malformed, or contains unsupported values.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}},"Internal server error":{"description":"The server failed to process the request due to an unexpected condition.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/error"}}}}}},"paths":{"/payments/banks/{country}":{"get":{"summary":"List banks by country","deprecated":false,"description":"Returns all supported banks and financial institutions for the given country code. Use the `code` value as the `bank` field in `BANK_ACCOUNT`, `BREB`, or `SPEI` payment nodes.","operationId":"list-banks-by-country","tags":["Payment-methods"],"parameters":[{"name":"country","in":"path","description":"ISO country code (e.g., `CHL`, `COL`, `PER`, `MEX`).","required":true,"schema":{"type":"string"}},{"name":"x-api-key","in":"header","description":"The API key used for authentication when making requests to the API Gateway.","required":true,"schema":{"type":"string"}},{"name":"User-Agent","in":"header","description":"Identifies the application making the request.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Request processed successfully.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/bank"}}}},"headers":{}},"400":{"$ref":"#/components/responses/Bad request","description":"Invalid request parameters or payload."},"500":{"$ref":"#/components/responses/Internal server error","description":"Unexpected internal server error."}}}}}}
```