---
title: Get a Budget Order by ID
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/get-shared-budgets-_id_
---

# Get a Budget Order by ID

Retrieves a single budget order by its ID.

## URL

GET https://api.ads.apple.com/v1/shared-budgets/{id}

## Path Parameters

id:

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: Successful operation. Returns SharedBudgetResponse (result: SharedBudget). 400 Bad Request: Bad Request. Returns ErrorResponse. 401 Unauthorized: Unauthorized. 403 Forbidden: Forbidden. 404 Not Found: Resource not found. Returns ErrorResponse. 429 Too Many Requests: Rate Limit Exceeded. See Applying Rate Limits. 500 Internal Server Error: Internal Server Error. Returns ErrorResponse.

## Discussion

Discussion This endpoint retrieves the full details of a specific budget order by its ID. The response includes the budget order’s value, active date range, assigned ad accounts, and invoice details. Payload Examples

## See Also

- [Create a Budget Order](apple-ads-platform-api/post-shared-budgets.md)
- [Query Budget Orders](apple-ads-platform-api/post-shared-budgets-query.md)
- [Update a Budget Order](apple-ads-platform-api/put-shared-budgets-_id_.md)
- [Delete a Budget Order](apple-ads-platform-api/delete-shared-budgets-_id_.md)