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

# List all one-time use offer codes for an auto-renewable subscription

Get details about a one-time use code for a specific subscription offer for an auto-renewable subscription.

## URL

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

## Path Parameters

id:

## Query Parameters

fields[subscriptionOfferCodeOneTimeUseCodes]: fields[subscriptionOfferCodes]: include: limit:

## Response Codes

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

## See Also

### Managing One-Time Use Offer Codes

- [Create one-time use offer codes](appstoreconnectapi/post-v1-subscriptionoffercodeonetimeusecodes.md)
- [Read one-time use offer code information](appstoreconnectapi/get-v1-subscriptionoffercodeonetimeusecodes-_id_.md)
- [Deactivate one-time use offer codes](appstoreconnectapi/patch-v1-subscriptionoffercodeonetimeusecodes-_id_.md)
- [List one-time use offer code values](appstoreconnectapi/get-v1-subscriptionoffercodeonetimeusecodes-_id_-values.md)
- [List one-time-use code IDs for a subscription offer code](appstoreconnectapi/get-v1-subscriptionoffercodes-_id_-relationships-onetimeusecodes.md)