> For the complete documentation index, see [llms.txt](https://docs.marsproxies.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.marsproxies.com/marsproxies-documentation/overview/residential-proxies/api/cards.md).

# Cards

Payment cards on the account

## List user payment cards

> Returns the list of active payment cards on the account.

```json
{"openapi":"3.1.0","info":{"title":"MarsProxies Residential API documentation","version":"1.0.0"},"tags":[{"name":"cards","description":"Payment cards on the account"}],"servers":[{"url":"https://api.marsproxies.com","description":"MarsProxies API"}],"security":[{"api_token":[]}],"components":{"securitySchemes":{"api_token":{"type":"http","scheme":"bearer","description":"API token generated in the MarsProxies dashboard under /settings. Send it as a Bearer token in the Authorization header."}},"schemas":{"CardCollection":{"title":"Card Collection","description":"List of active payment cards on the account.","required":["data"],"properties":{"data":{"description":"Cards on the account, with the default card listed first.","type":"array","items":{"$ref":"#/components/schemas/CardResource"}}},"type":"object"},"CardResource":{"title":"Card Resource","description":"A single payment card on the account.","required":["id","provider","custom_name","default","payment_method","card_type","currency","last_four_digits","expiry_date"],"properties":{"id":{"description":"Unique card identifier.","type":"integer"},"provider":{"description":"Payment provider that issued the card token.","type":"string"},"custom_name":{"description":"User-provided friendly name for the card.","type":["string","null"]},"default":{"description":"Whether this card is the default payment method.","type":"boolean"},"payment_method":{"description":"Payment method type.","type":"string"},"card_type":{"description":"Card brand reported by the provider.","type":["string","null"]},"currency":{"description":"Card currency.","type":["string","null"]},"last_four_digits":{"description":"Last four digits of the card number.","type":["string","null"]},"expiry_date":{"description":"Card expiry date.","type":["string","null"]}},"type":"object"},"ErrorEnvelopeDTO":{"title":"Error Envelope","description":"Error response envelope","required":["error"],"properties":{"error":{"$ref":"#/components/schemas/ErrorResponseDTO"}},"type":"object","xml":{"name":"ErrorEnvelopeDTO"}},"ErrorResponseDTO":{"title":"Error Response","description":"Error Response","required":["code","message","trace_id"],"properties":{"code":{"title":"code","description":"Error code","type":"string"},"message":{"title":"message","description":"Error message","type":"string"},"trace_id":{"title":"trace_id","description":"Request trace ID for correlating logs and support requests","type":"string"}},"type":"object","xml":{"name":"ErrorResponseDTO"}}}},"paths":{"/v1/cards":{"get":{"tags":["cards"],"summary":"List user payment cards","description":"Returns the list of active payment cards on the account.","operationId":"getCards","responses":{"200":{"description":"Active payment cards","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardCollection"}}}},"401":{"description":"Missing or invalid API token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelopeDTO"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelopeDTO"}}}},"500":{"description":"Unknown error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelopeDTO"}}}}}}}}}
```