> ## Documentation Index > Fetch the complete documentation index at: https://docs.sellfern.com/llms.txt > Use this file to discover all available pages before exploring further. # List order items > Lists order items for the authenticated organization with filtering and pagination. The public schema focuses on item status and fulfillment visibility and excludes cost fields. Scope notes: Requires order item read scope and authenticated organization isolation. Read-only endpoint. ## OpenAPI ````yaml /public_openapi_v1.json get /orderItems openapi: 3.0.0 info: title: Sellfern Public API version: 1.0.0 description: OpenAPI spec for Sellfern Public V1 developer docs. contact: name: Sellfern Support email: support@sellfern.com servers: - url: https://api.sellfern.com description: Production API security: - ApiKeyAuth: [] tags: - name: Organizations And Stores - name: Orders - name: Order Items - name: Products And Catalog - name: Webhooks paths: /orderItems: get: tags: - Order Items summary: List order items description: >- Lists order items for the authenticated organization with filtering and pagination. The public schema focuses on item status and fulfillment visibility and excludes cost fields. Scope notes: Requires order item read scope and authenticated organization isolation. Read-only endpoint. parameters: - name: search in: query required: false schema: type: string description: Search SKU, order number, item name, or related item text. - name: status in: query required: false schema: type: string description: Filter by item status. - name: storeName in: query required: false schema: type: string description: Filter by store name. - name: startDate in: query required: false schema: type: string format: date description: Only include items from orders on or after this date. - name: endDate in: query required: false schema: type: string format: date description: Only include items from orders on or before this date. - name: timezone in: query required: false schema: type: string example: America/New_York description: IANA timezone used for date interpretation. - name: supplier in: query required: false schema: type: string description: Filter by supplier name or ID. - name: missingSku in: query required: false schema: type: boolean description: Filter to items missing SKUs. - name: missingDesign in: query required: false schema: type: boolean description: Filter to items missing design files. - name: missingCost in: query required: false schema: type: boolean description: >- Filter to items missing cost in the app. Cost values are not returned in the public response schema. - name: sortField in: query required: false schema: type: string description: Field name to sort by. - name: sortOrder in: query required: false schema: type: string enum: - asc - desc description: Sort direction. - name: page in: query required: false schema: type: integer minimum: 1 default: 1 description: Page number, 1-indexed. - name: limit in: query required: false schema: type: integer minimum: 1 default: 50 description: Number of results per page. responses: '200': description: Paginated order items returned successfully. content: application/json: schema: type: object required: - success - data - meta properties: success: type: boolean example: true data: type: array items: $ref: '#/components/schemas/PublicOrderItem' meta: type: object required: - pagination properties: request_id: type: string description: Request identifier, when available. pagination: $ref: '#/components/schemas/PaginationMeta' '401': $ref: '#/components/responses/UnauthorizedError' '403': $ref: '#/components/responses/ForbiddenError' '429': $ref: '#/components/responses/RateLimitedError' security: - ApiKeyAuth: [] components: schemas: PublicOrderItem: type: object properties: id: type: string example: '987654321' orderId: type: string example: '1234567890' customOrderId: type: string nullable: true name: type: string sku: type: string nullable: true customSku: type: string nullable: true spu: type: string nullable: true quantity: type: integer example: 1 price: type: number status: type: string nullable: true example: In Production assignedSupplier: type: string nullable: true subSupplier: type: string nullable: true material: type: string nullable: true materialId: type: string nullable: true designUrl: type: string nullable: true trackingCode: type: string nullable: true carrier: type: string nullable: true style: type: string nullable: true type: type: string nullable: true size: type: string nullable: true color: type: string nullable: true variations: type: string nullable: true personalization: type: string nullable: true comment: type: string nullable: true idService: type: string nullable: true phone: type: string nullable: true orderDate: type: string nullable: true storeName: type: string nullable: true isGift: type: boolean nullable: true customerName: type: string nullable: true customerAddress: type: string nullable: true shipName: type: string nullable: true shipAddress1: type: string nullable: true shipAddress2: type: string nullable: true shipCity: type: string nullable: true shipState: type: string nullable: true shipZipcode: type: string nullable: true shipCountry: type: string nullable: true vatIossNumber: type: string nullable: true PaginationMeta: type: object required: - page - page_size - total - total_pages properties: page: type: integer example: 1 page_size: type: integer example: 50 total: type: integer example: 125 total_pages: type: integer example: 3 ResponseMeta: type: object properties: request_id: type: string description: Request identifier, when available. responses: UnauthorizedError: description: Missing or invalid API key. content: application/json: schema: type: object required: - success - error properties: success: type: boolean example: false error: type: object required: - code - message properties: code: type: string example: unauthorized message: type: string example: Missing or invalid API key. meta: $ref: '#/components/schemas/ResponseMeta' ForbiddenError: description: API key lacks the required scope. content: application/json: schema: type: object required: - success - error properties: success: type: boolean example: false error: type: object required: - code - message properties: code: type: string example: missing_scope message: type: string example: Missing required scope. meta: $ref: '#/components/schemas/ResponseMeta' RateLimitedError: description: Rate limit exceeded. content: application/json: schema: type: object required: - success - error properties: success: type: boolean example: false error: type: object required: - code - message properties: code: type: string example: rate_limited message: type: string example: Rate limit exceeded. meta: $ref: '#/components/schemas/ResponseMeta' securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Sellfern public API key scoped to the authenticated organization. Do not use user JWTs for public integrations. ````