---
title: List all custom offer codes for an auto-renewable subscription
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/get-v1-subscriptionoffercodes-_id_-customcodes
---

# List all custom offer codes for an auto-renewable subscription

Get details about a custom code for a specific subscription offer for an auto-renewable subscription.

## URL

GET https://api.appstoreconnect.apple.com/v1/subscriptionOfferCodes/{id}/customCodes

## Path Parameters

id:

## Query Parameters

fields[subscriptionOfferCodeCustomCodes]: fields[subscriptionOfferCodes]: include: limit:

## Response Codes

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

## See Also

### Managing Custom Offer Codes

- [Create custom offer codes](appstoreconnectapi/post-v1-subscriptionoffercodecustomcodes.md)
- [List custom code IDs for a subscription offer code](appstoreconnectapi/get-v1-subscriptionoffercodes-_id_-relationships-customcodes.md)
- [Read custom offer code information](appstoreconnectapi/get-v1-subscriptionoffercodecustomcodes-_id_.md)
- [Deactivate custom offer codes](appstoreconnectapi/patch-v1-subscriptionoffercodecustomcodes-_id_.md)