> ## Documentation Index > Fetch the complete documentation index at: https://docs.nautilus.co/llms.txt > Use this file to discover all available pages before exploring further. # List POS transactions > Point-of-sale resource for the organization that owns the API key. The POS is resolved server-side from that organization; callers never name or select a provider. Organizations whose POS data is not yet available through this API receive 404. Credentials, connection details, provider configuration, and raw provider payloads are never returned. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/pos/transactions openapi: 3.1.0 info: title: Nautilus Public API version: 1.0.0 description: >- The canonical /api/v1 data endpoints are tenant-scoped and use a Clerk tenant API key as a Bearer token. The key's organizationId is the sole tenant scope; caller-supplied organization IDs are not accepted. Detail reads return 404 for both missing and cross-tenant records. Canonical collections use the standard envelope and endpoint-bound cursor pagination. Timestamps are UTC ISO 8601 values and monetary amounts ending in Cents are integer cents. Responses use narrow serializers that exclude credentials and internal provider or workflow data. GET /api/v1/openapi.json and the headless form submission endpoint do not require an API key. Headless submissions use a published form ID and its configured form password, grant submission access only, and return the separate receipt/error shapes documented on that operation. Use headless submissions for published forms supported by headless intake. Copy the endpoint and saved field IDs from Share > Use your own form; hosted-only form requirements remain unchanged. servers: - url: https://app.nautilus.co security: - tenantApiKey: [] tags: - name: Contract - name: Cancellations - name: Sites - name: Products - name: Checkout links - name: Purchases - name: Contact lists - name: Contacts - name: Marketing - name: Forms - name: Vouchers - name: Links - name: Automations - name: Surveys - name: Cases - name: Reviews - name: POS description: >- Point-of-sale data for the organization that owns the API key. The POS is resolved server-side from that organization; requests never name or select a provider. - name: Analytics - name: Messaging - name: Legacy description: Deprecated noncanonical endpoints retained for compatibility. paths: /api/v1/pos/transactions: get: tags: - POS summary: List POS transactions description: >- Point-of-sale resource for the organization that owns the API key. The POS is resolved server-side from that organization; callers never name or select a provider. Organizations whose POS data is not yet available through this API receive 404. Credentials, connection details, provider configuration, and raw provider payloads are never returned. operationId: listPosTransactions parameters: - name: customerId in: query required: false schema: type: string - name: siteId in: query required: false schema: type: string - name: type in: query required: false schema: type: string - name: completedAfter in: query required: false schema: type: string format: date-time description: UTC ISO 8601 timestamp. description: >- Inclusive completion lower bound. Required with customerId for organizations backed by the shared POS mirror. Must include an explicit UTC offset. - name: completedBefore in: query required: false schema: type: string format: date-time description: UTC ISO 8601 timestamp. description: >- Inclusive completion upper bound. Must include an explicit UTC offset. - name: recurringSale in: query required: false schema: type: boolean description: Filter recurring sales. - name: recurringPayment in: query required: false schema: type: boolean description: Filter recurring payments. - name: recurringRedemption in: query required: false schema: type: boolean description: Filter recurring redemptions. - name: prepaidSale in: query required: false schema: type: boolean description: Filter prepaid sales. - name: prepaidRedemption in: query required: false schema: type: boolean description: Filter prepaid redemptions. - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 500 default: 100 description: >- Page size. Invalid values use 100; values above 500 are capped at 500. - name: cursor in: query required: false schema: type: string description: >- Opaque continuation token returned by this POS transactions collection. Cursors are bound to this endpoint (and, for nested or sorted collections, to that parent or sort) and cannot be reused elsewhere. responses: '200': description: Tenant-scoped collection. content: application/json: schema: allOf: - $ref: '#/components/schemas/CollectionEnvelope' - type: object properties: data: type: array items: $ref: '#/components/schemas/PosTransaction' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalServerError' components: schemas: CollectionEnvelope: type: object additionalProperties: false properties: organizationId: type: string filters: type: object additionalProperties: true description: Normalized filters actually applied to the request. data: type: array items: {} pagination: $ref: '#/components/schemas/Pagination' required: - organizationId - filters - data - pagination description: Standard envelope for canonical collection endpoints. PosTransaction: type: object additionalProperties: false properties: transactionId: type: string transactionNumber: type: integer customerId: anyOf: - type: string - type: 'null' customerName: anyOf: - type: string - type: 'null' siteId: anyOf: - type: string - type: 'null' completedAt: type: string format: date-time description: UTC ISO 8601 timestamp. insertedAt: anyOf: - type: string format: date-time description: UTC ISO 8601 timestamp. - type: 'null' type: type: string totalCents: type: integer description: Amount in integer cents. items: type: array items: type: object additionalProperties: false properties: sku: anyOf: - type: string - type: 'null' name: anyOf: - type: string - type: 'null' department: anyOf: - type: string - type: 'null' quantity: anyOf: - type: number - type: 'null' grossCents: anyOf: - type: integer description: Amount in integer cents. - type: 'null' netCents: anyOf: - type: integer description: Amount in integer cents. - type: 'null' taxCents: anyOf: - type: integer description: Amount in integer cents. - type: 'null' discountCents: anyOf: - type: integer description: Amount in integer cents. - type: 'null' additionalFeeCents: anyOf: - type: integer description: Amount in integer cents. - type: 'null' voided: anyOf: - type: boolean - type: 'null' required: - sku - name - department - quantity - grossCents - netCents - taxCents - discountCents - additionalFeeCents - voided discounts: type: array items: type: object additionalProperties: false properties: sku: anyOf: - type: string - type: 'null' code: anyOf: - type: string - type: 'null' name: anyOf: - type: string - type: 'null' amountCents: anyOf: - type: integer description: Amount in integer cents. - type: 'null' appliedToItemName: anyOf: - type: string - type: 'null' required: - sku - code - name - amountCents - appliedToItemName tenders: type: array items: type: object additionalProperties: false properties: type: anyOf: - type: string - type: 'null' subtype: anyOf: - type: string - type: 'null' amountCents: anyOf: - type: integer description: Amount in integer cents. - type: 'null' changeCents: anyOf: - type: integer description: Amount in integer cents. - type: 'null' totalCents: anyOf: - type: integer description: Amount in integer cents. - type: 'null' required: - type - subtype - amountCents - changeCents - totalCents paymentSummary: type: object additionalProperties: false properties: tenderCount: anyOf: - type: integer - type: 'null' tenderedCents: anyOf: - type: integer description: Amount in integer cents. - type: 'null' changeCents: anyOf: - type: integer description: Amount in integer cents. - type: 'null' netPaidCents: anyOf: - type: integer description: Amount in integer cents. - type: 'null' required: - tenderCount - tenderedCents - changeCents - netPaidCents description: Null when the organization's POS does not record tender amounts. recurring: type: object additionalProperties: false properties: sale: type: boolean payment: type: boolean redemption: type: boolean required: - sale - payment - redemption prepaid: type: object additionalProperties: false properties: sale: type: boolean redemption: type: boolean required: - sale - redemption operations: type: object additionalProperties: false properties: salesDeviceName: anyOf: - type: string - type: 'null' cashierName: anyOf: - type: string - type: 'null' greeterName: anyOf: - type: string - type: 'null' vehicleLicensePlate: anyOf: - type: string - type: 'null' required: - salesDeviceName - cashierName - greeterName - vehicleLicensePlate required: - transactionId - transactionNumber - customerId - customerName - siteId - completedAt - insertedAt - type - totalCents - items - discounts - tenders - paymentSummary - recurring - prepaid - operations description: >- Sanitized point-of-sale transaction. No provider credentials, connection details, configuration, or raw payloads are returned. Pagination: type: object additionalProperties: false properties: limit: type: integer hasMore: type: boolean nextCursor: anyOf: - type: string - type: 'null' required: - limit - hasMore - nextCursor Error: type: object additionalProperties: false properties: error: type: string required: - error responses: BadRequest: description: >- Malformed parameters, unsupported provider, or unavailable resource for this organization. content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: Missing, invalid, legacy, or non-tenant Bearer credential. content: application/json: schema: $ref: '#/components/schemas/Error' NotFound: description: >- The resource does not exist, is unavailable, or belongs to another organization. content: application/json: schema: $ref: '#/components/schemas/Error' InternalServerError: description: Internal server error. No internal exception data is exposed. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: tenantApiKey: type: http scheme: bearer bearerFormat: Clerk tenant API key description: >- Clerk tenant API key. The organizationId encoded by the key is the exact and only tenant scope. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.