---
title: List all offer codes for a subscription
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/get-v1-subscriptions-_id_-offercodes
---

# List all offer codes for a subscription

Get a list of subscription offer codes for a specific auto-renewable subscription.

## URL

GET https://api.appstoreconnect.apple.com/v1/subscriptions/{id}/offerCodes

## Path Parameters

id:

## Query Parameters

fields[subscriptionOfferCodeCustomCodes]: fields[subscriptionOfferCodeOneTimeUseCodes]: fields[subscriptionOfferCodePrices]: fields[subscriptionOfferCodes]: fields[subscriptions]: filter[territory]: include: limit: limit[customCodes]: limit[oneTimeUseCodes]: limit[prices]:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 :

## See Also

### Endpoints

- [Create an auto-renewable subscription](appstoreconnectapi/post-v1-subscriptions.md)
- [Read subscription information](appstoreconnectapi/get-v1-subscriptions-_id_.md)
- [Modify an auto-renewable subscription](appstoreconnectapi/patch-v1-subscriptions-_id_.md)
- [Delete a subscription](appstoreconnectapi/delete-v1-subscriptions-_id_.md)
- [List all localizations for an auto-renewable subscription](appstoreconnectapi/get-v1-subscriptions-_id_-subscriptionlocalizations.md)
- [List localization IDs for an auto-renewable subscription](appstoreconnectapi/get-v1-subscriptions-_id_-relationships-subscriptionlocalizations.md)
- [List all introductory offers for a subscription](appstoreconnectapi/get-v1-subscriptions-_id_-introductoryoffers.md)
- [List all introductory offer resource ids for an auto-renewable subscription](appstoreconnectapi/get-v1-subscriptions-_id_-relationships-introductoryoffers.md)
- [Delete an introductory offer from a subscription](appstoreconnectapi/delete-v1-subscriptions-_id_-relationships-introductoryoffers.md)
- [Read promoted purchase information for a subscription](appstoreconnectapi/get-v1-subscriptions-_id_-promotedpurchase.md)
- [Get the promoted purchase ID for an auto-renewable subscription](appstoreconnectapi/get-v1-subscriptions-_id_-relationships-promotedpurchase.md)
- [List offer code IDs for an auto-renewable subscription](appstoreconnectapi/get-v1-subscriptions-_id_-relationships-offercodes.md)
- [List all promotional offer resource ids for an auto-renewable subscription](appstoreconnectapi/get-v1-subscriptions-_id_-promotionaloffers.md)
- [List promotional offer IDs for an auto-renewable subscription](appstoreconnectapi/get-v1-subscriptions-_id_-relationships-promotionaloffers.md)
- [List all price points for a subscription](appstoreconnectapi/get-v1-subscriptions-_id_-pricepoints.md)