> ## Documentation Index > Fetch the complete documentation index at: https://docs.use.observer/llms.txt > Use this file to discover all available pages before exploring further. # List SLA statements > Newest first. Requires the SLA Ledger plan feature (403 feature_locked otherwise). ## OpenAPI ````yaml api-reference/openapi.json GET /sla/statements openapi: 3.1.0 info: title: Observer API version: 1.0.0 description: >- Public API for Observer: read services, metrics, SLOs and SLA statements; manage incidents, maintenance windows, manual metric status, config as code and Observer Agents. Bearer-auth via API keys (obs_pub_…), scoped per key. RFC 7807 problem-detail errors. Cursor pagination. Rate limits are per organization. servers: - url: https://use.observer/api/v1 security: - bearerAuth: [] paths: /sla/statements: get: tags: - sla summary: List SLA Ledger statements description: >- Newest first. Requires the SLA Ledger plan feature (403 feature_locked otherwise). operationId: listSlaStatements parameters: - name: limit in: query description: Page size. Out-of-range values are clamped. schema: type: integer minimum: 1 maximum: 200 default: 50 - name: cursor in: query description: Opaque cursor from the previous page's next_cursor. schema: type: string - name: period in: query schema: type: string pattern: ^\d{4}-(0[1-9]|1[0-2])$ description: YYYY-MM, in each statement's own timezone. - name: customer_id in: query schema: type: string format: uuid - name: state in: query schema: type: string enum: - draft - in_review - approved - delivered - superseded - void responses: '200': description: ok content: application/json: schema: type: object required: - items properties: items: type: array items: $ref: '#/components/schemas/SlaStatement' next_cursor: type: - string - 'null' '400': description: >- `invalid_period`: `period` must be YYYY-MM. `invalid_customer_id`: `customer_id` must be a uuid. `invalid_state`: unknown `state`. `invalid_cursor`: `cursor` is not a `next_cursor` value returned by this endpoint. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '401': description: >- `unauthenticated`: no bearer token was sent, or the key is invalid or revoked. `detail` distinguishes the two. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '403': description: >- `forbidden`: the key lacks `read:sla`. `plan_does_not_permit_api`: the plan does not include the public API. `feature_locked`: the plan does not include the SLA Ledger. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '404': description: '`not_found`: not found. Cross-tenant ids return the same response.' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '429': description: >- `rate_limited`: the organization's per-minute or daily request limit is used up (`limit.window` says which). Limits are per organization, shared by every key. The response carries `Retry-After` and `retry_after`, in seconds. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '500': description: '`internal_error`: an unhandled server error. Safe to retry.' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '503': description: '`unavailable`: SLA statements are not available yet.' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' security: - bearerAuth: - read:sla components: schemas: SlaStatement: type: object required: - id - customer_id - period_label - period_start - period_end - revision - state - sha256 properties: id: type: string format: uuid customer_id: type: string format: uuid customer_name: type: - string - 'null' contract_id: type: - string - 'null' format: uuid period_label: type: string period_start: type: string format: date-time period_end: type: string format: date-time timezone: type: string description: IANA timezone the period is measured in. revision: type: integer state: type: string enum: - draft - in_review - approved - delivered - superseded - void attainment_min: type: - string - 'null' description: >- Lowest line attainment (percent, exact decimal string; display truncates, never rounds). credit_pct: type: - string - 'null' description: Calculated credit percent (not an invoice). credit_amount_minor: type: - integer - 'null' currency: type: - string - 'null' credit_state: type: string enum: - none - owed - issued - waived sha256: type: string description: sha256 of the canonical JSON payload. signature: type: - string - 'null' description: >- Ed25519 over the sha256 digest bytes, base64. Verify against /.well-known/observer-signing-keys. signing_key_id: type: - string - 'null' generated_at: type: string format: date-time approved_at: type: - string - 'null' format: date-time sent_at: type: - string - 'null' format: date-time Problem: type: object required: - type - title - status example: type: https://docs.use.observer/api/getting-started/errors#forbidden title: forbidden status: 403 detail: 'missing scope: write:incidents' properties: type: type: string format: uri description: Errors reference URI with the title token as the fragment. example: https://docs.use.observer/api/getting-started/errors#forbidden title: type: string description: Stable error token. Branch on this, not on detail. status: type: integer detail: type: string description: Human-readable explanation. Wording may change. retry_after: type: integer description: >- 429 only: seconds until the exhausted window resets (mirrors Retry-After). limit: type: object description: '429 only: which organization limit was hit.' properties: scope: type: string enum: - organization window: type: string enum: - minute - day max: type: integer plan: type: string errors: type: array description: >- Validation failures (config_invalid, invalid_customer_targeting): one entry per problem. items: type: object properties: path: type: string message: type: string warnings: type: array description: >- config_invalid only: the same non-fatal warnings a successful apply returns. items: type: object properties: path: type: string message: type: string unknown_customers: type: array description: >- unknown_customers only: the submitted values that matched no customer in your organization. items: type: string referenced_by: type: object description: >- in_use only: what depends on the object (slos, pages: lists of { id, config_key, name }; subscribers: a count). quota: type: object description: >- quota_exceeded / feature_locked on a create only: the plan limit that blocked it. properties: capability: type: string used: type: - integer - 'null' cap: type: - integer - 'null' plan: type: - string - 'null' upgrade: type: object description: >- Plan-limit problems only, when a higher plan lifts the limit: the smallest such plan and the pricing page. properties: plan: type: string label: type: string url: type: string format: uri securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: obs_pub_ description: >- An organization API key (obs_pub_…) sent as `Authorization: Bearer `. Each key carries scopes; an endpoint lists the scope it needs. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.