> ## Documentation Index > Fetch the complete documentation index at: https://docs.creem.io/llms.txt > Use this file to discover all available pages before exploring further. # List customer orders > Retrieve a paginated list of orders for a specific customer. ## OpenAPI ````yaml get /v1/customers/{id}/orders openapi: 3.0.0 info: title: Creem API description: >- Creem is an all-in-one platform for managing subscriptions and recurring revenue, tailored specifically for today's SaaS companies. It enables you to boost revenue, enhance customer retention, and scale your operations seamlessly. version: v1 contact: name: Creem Support url: https://creem.io email: support@creem.io license: name: Commercial url: https://creem.io/terms termsOfService: https://creem.io/terms servers: - url: https://api.creem.io description: Production — live API for processing real transactions and data. x-speakeasy-server-id: prod - url: https://test-api.creem.io description: Test — sandbox API for development and testing with no real charges. x-speakeasy-server-id: test security: [] tags: [] externalDocs: description: Creem Documentation url: https://docs.creem.io paths: /v1/customers/{id}/orders: get: tags: - Customers summary: List customer orders description: Retrieve a paginated list of orders for a specific customer. operationId: listCustomerOrders parameters: - name: id required: true in: path description: The unique identifier of the customer schema: type: string - name: page_number required: false in: query description: The page number for pagination. schema: default: 1 example: 1 type: number - name: page_size required: false in: query description: The number of items per page. schema: default: 10 example: 10 type: number responses: '200': description: Successfully retrieved customer orders content: application/json: schema: $ref: '#/components/schemas/OrderListEntity' '400': description: Bad Request - Invalid input parameters '401': description: Unauthorized - Invalid or missing API key '404': description: Not Found - Resource does not exist security: - ApiKey: [] components: schemas: OrderListEntity: type: object properties: items: description: List of order items items: $ref: '#/components/schemas/OrderEntity' type: array pagination: description: Pagination details for the list allOf: - $ref: '#/components/schemas/PaginationEntity' required: - items - pagination OrderEntity: type: object properties: id: type: string description: Unique identifier for the object. mode: $ref: '#/components/schemas/EnvironmentMode' object: type: string description: >- String representing the object's type. Objects of the same type share the same value. customer: type: string description: The customer who placed the order. nullable: true product: type: string description: The product associated with the order. transaction: type: string description: The transaction ID of the order example: tx_1234567890 nullable: true discount: type: string description: The discount ID of the order example: dis_1234567890 nullable: true amount: type: number description: The total amount of the order in cents. 1000 = $10.00 example: 2000 sub_total: type: number description: The subtotal of the order in cents. 1000 = $10.00 example: 1800 tax_amount: type: number description: The tax amount of the order in cents. 1000 = $10.00 example: 200 discount_amount: type: number description: The discount amount of the order in cents. 1000 = $10.00 example: 100 amount_due: type: number description: The amount due for the order in cents. 1000 = $10.00 example: 1900 amount_paid: type: number description: The amount paid for the order in cents. 1000 = $10.00 example: 1900 currency: type: string description: >- Three-letter ISO currency code, in uppercase. Must be a supported currency. example: USD fx_amount: type: number description: The amount in the foreign currency, if applicable. example: 15 nullable: true fx_currency: type: string description: Three-letter ISO code of the foreign currency, if applicable. example: EUR nullable: true fx_rate: type: number description: >- The exchange rate used for converting between currencies, if applicable. example: 1.2 nullable: true status: $ref: '#/components/schemas/OrderStatus' example: pending type: $ref: '#/components/schemas/OrderType' example: recurring affiliate: type: string description: The affiliate associated with the order, if applicable. nullable: true created_at: format: date-time type: string description: Creation date of the order example: '2023-09-13T00:00:00Z' updated_at: format: date-time type: string description: Last updated date of the order example: '2023-09-13T00:00:00Z' required: - id - mode - object - product - amount - currency - status - type - created_at - updated_at PaginationEntity: type: object properties: total_records: type: number description: Total number of records in the list example: 0 total_pages: type: number description: Total number of pages available example: 0 current_page: type: number description: The current page number example: 1 next_page: type: number description: The next page number, or null if there is no next page example: 2 nullable: true prev_page: type: number description: The previous page number, or null if there is no previous page example: null nullable: true required: - total_records - total_pages - current_page - next_page - prev_page EnvironmentMode: type: string description: String representing the environment. enum: - test - prod - sandbox OrderStatus: type: string description: Current status of the order. enum: - pending - paid OrderType: type: string description: >- The type of order. This can specify whether it's a regular purchase, subscription, etc. enum: - recurring - onetime securitySchemes: ApiKey: type: apiKey in: header name: x-api-key description: >- API key for authentication. You can find your API key in the Creem dashboard under Settings > API Keys. ````