Obtain all Refunds

Designing

GET

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

Retrieves a cursor-paginated list of refund attempts (refund_entry, rfe_ prefix) belonging to the authenticated client, sorted by created_at descending (most recent first, not configurable).

Use original_payin_id, status, and/or created_at_from/created_at_to to filter the list. When multiple filters are provided they are combined with AND logic.

Pagination

This endpoint uses cursor-based pagination (See Query prams for details).

Refunds is still under active development — some of the functionality described in this guide may not yet be available for your account. Contact your KAM (Key Account Manager) for the current rollout status.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Responses

🟢200OK

application/json

A page of refund attempts.

Bodyapplication/json

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.cobre.co/v1/v1/refunds?limit=50&next_cursor=eeynQ8vLm2KxP4wYz&prev_cursor=eynQ8vLm2KxP4wYz&original_payin_id=mm_xOBCRu3PPAby6E&status=completed&created_at_from=2026-01-15T00%3A00%3A00Z&created_at_to=2026-01-15T00%3A00%3A00Z' \
--header 'Authorization: Bearer <token>'

Response Example

200 - OK

{
    "data": [
        {
            "id": "rfe_bK2xLp9vNm4wYz",
            "object": "refund_entry",
            "livemode": true,
            "request_id": "req_bfsakd456fgh",
            "original_payin_id": "mm_xOBCRu3PPAby6E",
            "amount": 10000,
            "status": "waiting_for_information",
            "data_capture_url": "https://refund.cobre.co/...",
            "data_capture_url_expires_at": "2026-08-05T20:02:11Z",
            "redirect_url": "https://www.cobre.com/es-co",
            "created_at": "2026-08-05T14:02:11Z",
            "updated_at": "2026-08-05T14:02:11Z"
        },
        {
            "id": "rfe_bK2xLp9vNm4wYz",
            "object": "refund_entry",
            "livemode": true,
            "request_id": "req_bfsakd456fgh",
            "original_payin_id": "mm_xOBCRu3PPAby6E",
            "amount": 10000,
            "status": "waiting_for_information",
            "data_capture_url": "https://refund.cobre.co/...",
            "data_capture_url_expires_at": "2026-08-05T20:02:11Z",
            "redirect_url": "",
            "created_at": "2026-08-05T14:02:11Z",
            "updated_at": "2026-08-05T14:02:11Z"
        },
        {
            "id": "rfe_bK2xLp9vNm4wYz",
            "object": "refund_entry",
            "livemode": true,
            "request_id": "req_bfsakd456fgh",
            "original_payin_id": "mm_xOBCRu3PPAby6E",
            "amount": 10000,
            "status": "processing",
            "data_capture_url": "",
            "data_capture_url_expires_at": "",
            "redirect_url": "",
            "created_at": "2026-08-05T14:02:11Z",
            "updated_at": "2026-08-05T14:02:11Z"
        },
    ],
    "has_more": false,
    "next_cursor": "eyjasdkasdas...",
    "prev_cursor": "eyjasdkasdas..."
}

Modified at 2026-09-11 21:16:13

Obtain a Refund Summary

How to integrate with Cobre

Obtain all Refunds

Pagination#

Request

Responses

Pagination