Retrieve refund statements | Deel

Use this endpoint to retrieve a list of refund statements. This allows review of past transactions and reconciliation of accounts. Token scopes: accounting:read

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

1 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Query parameters

date_fromstringOptionalformat: "date"

Filters results to include payments created on or after this date (in ISO 8601 format).

date_tostringOptionalformat: "date"

Filters results to include payments created before this date (in ISO 8601 format).

cursorstringOptional

A cursor for pagination. Use the value returned in the ‘next_cursor’ field to get the next page of results.

currencieslist of strings or stringOptional

Filters payments by their currency codes. Can be a single currency code or an array of codes.

entitieslist of enums or enumOptional

Filters payments by legal entity type (e.g., ‘individual’ or ‘company’). Can be a single entity type or an array.

Response

Successfully retrieved refund statements.

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -G https://api.letsdeel.com/rest/v2/refund-statements \
>	-H "Authorization: Bearer <token>" \
>	-d date_from=2022-01-01 \
>	-d date_to=2022-12-31 \
>	-d cursor=BHF2gkMEMT8D9UQDmty66 \
>	-d currencies=USD \
>	-d currencies=EUR \
>	-d entities=company

1	{
2	"data": {
3	"rows": [
4	{
5	"id": "34d7Y48Ymu44g66fghN9F",
6	"label": "REC-2024-3",
7	"amount": "1500.00",
8	"status": "paid",
9	"currency": "USD",
10	"created_at": "2022-05-23T14:45:30.123Z",
11	"payment_method": "bank_transfer",
12	"paid_at": "2022-05-24T09:38:46.235Z"
13	}
14	],
15	"has_more": true,
16	"next_cursor": "BHF2gkMEMT8D9UQDmty66",
17	"total_count": 150
18	}
19	}

1	curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2	-H 'Authorization: Bearer YOUR-TOKEN-HERE'