> This page is for API, version 2026-01-01 (Stable) (default).
> For other versions, use one of these documentation indexes:
> - 2026-01-01 (Stable) (default): https://developer.deel.com/api/stable/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.deel.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.deel.com/_mcp/server.

# Retrieve a payment breakdown

GET https://api.letsdeel.com/rest/payments/{payment_id}/breakdown

Returns a breakdown of a payment made to Deel, with individual invoices and the Deel fee included as discrete line items.

 **Token scopes**: `accounting:read`

Reference: https://developer.deel.com/api/reference/endpoints/accounting/retrieve-a-payment-breakdown-v-2026-01-01

## Authentication

- `Authorization` header (bearer token, required) — ## 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)
- `Authorization` header (bearer token, required) — Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

## Servers

- `https://api.letsdeel.com/rest` (Production, default)
- `https://api-staging.letsdeel.com/rest` (Demo)

## Request

### Path parameters

- `payment_id` (string, required) — Unique identifier for the payment to retrieve the breakdown.

## Response

### 200

Successful operation.

- `data` (list of PaymentsPaymentIdBreakdownGetResponsesContentApplicationJsonSchemaDataItems, optional)

## Errors

### 400 Bad Request Error

Operation failed.

- `request` (ApiErrorRequest, optional)
- `errors` (list of ApiError, optional)

### 401 Unauthorized Error

Operation failed.

- `request` (ApiErrorRequest, optional)
- `errors` (list of ApiError, optional)

### 403 Forbidden Error

Operation failed.

- `request` (ApiErrorRequest, optional)
- `errors` (list of ApiError, optional)

### 404 Not Found Error

Operation failed.

- `request` (ApiErrorRequest, optional)
- `errors` (list of ApiError, optional)

### 500 Internal Server Error

Internal server error.

- `errors` (list of PaymentsPaymentIdBreakdownGetResponsesContentApplicationJsonSchemaErrorsItems, required)

## Types

### PaymentsPaymentIdBreakdownGetResponsesContentApplicationJsonSchemaDataItems

- `date` (string, optional) — Date associated with the payment breakdown.
- `work` (string, optional) — Base payment amount for work performed, including regular salary/wages and off-cycle payments.
- `bonus` (string, optional) — Additional bonus payment amount awarded to the worker.
- `total` (string, optional) — Total payment due for this breakdown item.
- `others` (string, optional) — Other payment amounts.
- `currency` (string, optional) — Currency code for this payment.
- `expenses` (string, optional) — Expenses related to the payment.
- `group_id` (PaymentsPaymentIdBreakdownGetResponsesContentApplicationJsonSchemaDataItemsGroupId, optional) — Unique identifier for the group associated with this payment. Empty for organization-level payments, individual payments, and standalone service fees that are not associated with a specific group.
- `overtime` (string, optional) — Overtime payment amount.
- `pro_rata` (string, optional) — Pro-rated payment amount.
- `approvers` (string, optional) — Comma-separated list of names of people who approved this payment. May be empty if no approvals were required or recorded.
- `frequency` (enum, optional) — Work unit scale from the contractor's work statement. Indicates how work is measured and reported (hourly, daily, weekly, monthly, or custom units). Empty for contracts with fixed payments that don't require work quantity tracking, such as milestone-based contracts and consulting agreements.
  - Allowed values: `hourly`, `daily`, `weekly`, `biweekly`, `semimonthly`, `monthly`, `custom`, ``
- `adjustment` (string, optional) — Adjustment amount for the payment.
- `deductions` (string, optional) — Deductions from the payment.
- `invoice_id` (string, optional) — Unique identifier of this resource.
- `commissions` (string, optional) — Commissions included in the payment.
- `contract_id` (string, optional, nullable) — Public identifier of the contract this line item belongs to. Null for service-fee and similar non-contract line items.
- `approve_date` (PaymentsPaymentIdBreakdownGetResponsesContentApplicationJsonSchemaDataItemsApproveDate, optional) — Date when the work report was approved by designated approvers. Empty for payments that don't require work report approval, such as service fees, management fees, and automated payments.
- `payment_date` (string, optional) — Date when the payment was made.
- `contract_type` (enum, optional, nullable) — Type of contract this payment relates to. Determines the nature of the work relationship and payment structure.
  - Allowed values: `milestones`, `time_based`, `ongoing_time_based`, `pay_as_you_go_time_based`, `commission`, `payg_milestones`, `payg_tasks`, `eor`, `peo`, `peo_csa`, `unknown`, `employee`, `global_payroll`, `shield_msa`, `gp_client_agreement`, `ep_client_agreement`, `power_of_attorney`, `debt_authorization`, `hris_direct_employee`, `hris_service_agreement`, `hofy_standalone_payment`, `wework_standalone_payment`, `travel_insurance_standalone_payment`, `health_insurance_standalone_payment`, `prepaid_billing`, `missing_saas_fees`, `one_off_service_fee`, `eor_management_fee`, `eor_one_off_management_fee`, `engage_monthly_subscription_fee`, `ats_subscription_fee`, `benefits_admin_monthly_platform_fee`, `contractor_outside_deel`, `late_payment_fee`, `background_check_standalone_payment`, `peo_service_fee`, `payment_processing_fee`, `deel_percentage_fee`, `netx_fee`, `prepaid_funding_statement`, `one_off_mobility_service_fee`, `prepaid_billing_expired_credits`, `implementation_delay`, `managed_hr_monthly_subscription_fee`, `expense_card`, `anon_report_fee`, `ic_maintenance_platform_fee`, `deel_it_order_statement`
- `processing_fee` (string, optional) — Processing fee amount applied to the payment.
- `contract_country` (string, optional) — Country where the contract is established.
- `contractor_email` (string, optional) — Email address of the worker.
- `payment_currency` (string, optional) — Currency in which the payment was processed.
- `contractor_pic_url` (string, optional, nullable) — URL to the worker's Deel avatar. Null if the worker has no avatar set or for non-worker line items.
- `contract_start_date` (PaymentsPaymentIdBreakdownGetResponsesContentApplicationJsonSchemaDataItemsContractStartDate, optional) — Start date of the contract. Empty for service agreements and fee-related contracts (such as equipment payments, insurance payments, and management fees) that don't have traditional contract start dates.
- `general_ledger_account` (string, optional) — General ledger account code or name for accounting purposes. May be configured at the group, company, or organization level. Empty if not configured.
- `total_payment_currency` (string, optional) — Total payment in the payment currency.
- `contractor_employee_name` (string, optional) — Name of the worker.
- `contractor_unique_identifier` (PaymentsPaymentIdBreakdownGetResponsesContentApplicationJsonSchemaDataItemsContractorUniqueIdentifier, optional) — Unique identifier for the worker. May be empty for certain contract types such as service agreements and fees.

### ApiErrorRequest

- `method` (string, optional) — The HTTP method of the failed request
- `url` (string, optional) — The relative URL of the failed request
- `status` (double, optional) — The status code of the response
- `api_req_id` (string, optional) — The request ID of the failed request
- `docs` (string, optional) — A link to the official documentation for the requested endpoint resource
- `source` (string, optional) — The source handler which produced the returned error
- `code` (double, optional) — The code of the source handler which produced the returned error

### ApiError

- `message` (string, optional) — A description of the returned error
- `path` (string, optional) — The JSON path where input validation failed

### PaymentsPaymentIdBreakdownGetResponsesContentApplicationJsonSchemaErrorsItems

- `code` (string, required)
- `message` (string, required)

### PaymentsPaymentIdBreakdownGetResponsesContentApplicationJsonSchemaDataItemsGroupId

Unique identifier for the group associated with this payment. Empty for organization-level payments, individual payments, and standalone service fees that are not associated with a specific group.

### PaymentsPaymentIdBreakdownGetResponsesContentApplicationJsonSchemaDataItemsApproveDate

Date when the work report was approved by designated approvers. Empty for payments that don't require work report approval, such as service fees, management fees, and automated payments.

### PaymentsPaymentIdBreakdownGetResponsesContentApplicationJsonSchemaDataItemsContractStartDate

Start date of the contract. Empty for service agreements and fee-related contracts (such as equipment payments, insurance payments, and management fees) that don't have traditional contract start dates.

### PaymentsPaymentIdBreakdownGetResponsesContentApplicationJsonSchemaDataItemsContractorUniqueIdentifier

Unique identifier for the worker. May be empty for certain contract types such as service agreements and fees.

## Examples

**Response**

```json
{
  "data": [
    {
      "date": "2022-10-01T00:59:28.482Z",
      "work": "3000.00",
      "bonus": "500.00",
      "total": "3500.00",
      "others": "0.00",
      "currency": "USD",
      "expenses": "0.00",
      "group_id": "4fd2daf5-7d59-4990-ba17-5dfc5f1034d0",
      "overtime": "0.00",
      "pro_rata": "0.00",
      "approvers": "John Smith, Jane Doe",
      "frequency": "monthly",
      "adjustment": "0.00",
      "deductions": "0.00",
      "invoice_id": "GqaY5BHQJUAM2Jg9kq2j2",
      "commissions": "0.00",
      "contract_id": "37nex2x",
      "approve_date": "2022-10-28T14:32:15.847Z",
      "payment_date": "2022-11-01T17:20:32.837Z",
      "contract_type": "ongoing_time_based",
      "processing_fee": "0.00",
      "contract_country": "US",
      "contractor_email": "name@email.com",
      "payment_currency": "USD",
      "contractor_pic_url": "https://cdn.deel.com/avatars/user-123.jpg",
      "contract_start_date": "2020-03-31T10:58:49.780Z",
      "general_ledger_account": "6000 - Office Expenses",
      "total_payment_currency": "1000.00",
      "contractor_employee_name": "Jane Doe",
      "contractor_unique_identifier": "550e8400-e29b-41d4-a716-446655440000"
    }
  ]
}
```

**SDK Code**

```python
import requests

url = "https://api.letsdeel.com/rest/payments/YJdYFAA586JYf8A324T57/breakdown"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.letsdeel.com/rest/payments/YJdYFAA586JYf8A324T57/breakdown';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.letsdeel.com/rest/payments/YJdYFAA586JYf8A324T57/breakdown"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.letsdeel.com/rest/payments/YJdYFAA586JYf8A324T57/breakdown")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.letsdeel.com/rest/payments/YJdYFAA586JYf8A324T57/breakdown")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.letsdeel.com/rest/payments/YJdYFAA586JYf8A324T57/breakdown', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.letsdeel.com/rest/payments/YJdYFAA586JYf8A324T57/breakdown");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.letsdeel.com/rest/payments/YJdYFAA586JYf8A324T57/breakdown")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```