> ## Documentation Index
> Fetch the complete documentation index at: https://docs.simplepay.mx/llms.txt
> Use this file to discover all available pages before exploring further.

# List enterprise product availability

> Referencia detallada para GET /v1/products/{id}/availability.

## Uso

Usalo para administrar productos del tenant, ofertas, disponibilidad o inventario empresarial asociado al catalogo SimplePay.

## Antes de llamar

| Tema             | Detalle                                           |
| ---------------- | ------------------------------------------------- |
| Metodo           | `GET`                                             |
| Ruta             | `/v1/products/{id}/availability`                  |
| Auth             | Bearer API key del ambiente correcto.             |
| Scope            | `availability:read`                               |
| Idempotencia     | No aplica para lecturas.                          |
| Guia relacionada | [API Reference overview](/api-reference/overview) |

## Patron recomendado

* Ejecuta esta lectura desde backend cuando incluya datos privados del tenant.
* Consulta el bloque OpenAPI de esta pagina para el shape exacto de parametros, body y respuestas.

## Ejemplo minimo

```bash terminal theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -sS "https://api.simplepay.mx/v1/products/id_123/availability" \
  -H "Authorization: Bearer $SIMPLEPAY_API_KEY"
```

## Errores a manejar

* `400` indica payload, parametros o estado invalido.
* `401` o `403` indican API key, ambiente o scopes incorrectos.
* `404` significa que el recurso no existe para ese tenant o ambiente.
* `429` y `5xx` se pueden reintentar con backoff; en writes conserva la misma idempotency key.

## Contrato OpenAPI

El playground, parametros, body y respuestas de abajo salen de `/openapi.json`. Si el contrato cambia, actualiza la spec y regenera esta pagina.


## OpenAPI

````yaml openapi.json GET /v1/products/{id}/availability
openapi: 3.1.0
info:
  title: SimplePay API
  version: '2026-06-13'
servers:
  - url: https://api.simplepay.mx
security:
  - SimplePayApiKey: []
paths:
  /v1/products/{id}/availability:
    get:
      summary: List enterprise product availability
      operationId: listProductAvailability
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
        - name: start
          in: query
          required: false
          schema:
            type: string
            format: date-time
        - name: end
          in: query
          required: false
          schema:
            type: string
            format: date-time
        - name: occurrence_id
          in: query
          required: false
          schema:
            type: string
        - name: tier_id
          in: query
          required: false
          schema:
            type: string
        - name: quantity
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
        - name: cursor
          in: query
          required: false
          schema:
            type: string
      responses:
        '200':
          description: List enterprise product availability
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductAvailabilityListResponse'
components:
  schemas:
    ProductAvailabilityListResponse:
      type: object
      additionalProperties: false
      properties:
        object:
          const: list
        url:
          type: string
        has_more:
          type: boolean
        data:
          type: array
          items:
            $ref: '#/components/schemas/ProductAvailabilityItem'
    ProductAvailabilityItem:
      allOf:
        - $ref: '#/components/schemas/ProductOffer'
        - type: object
          additionalProperties: false
          properties:
            requested_quantity:
              type: integer
              minimum: 1
    ProductOffer:
      type: object
      additionalProperties: false
      properties:
        object:
          const: product_offer
        product:
          type: string
          format: uuid
        occurrence:
          $ref: '#/components/schemas/ProductOfferOccurrence'
        tier:
          $ref: '#/components/schemas/ProductOfferTier'
        inventory_pool:
          $ref: '#/components/schemas/ProductOfferInventoryPool'
        inventory_mode:
          enum:
            - capacity_pool
            - date_range
            - instant
            - seated
            - unit_assignment
            - seat_map
            - request_to_book
        price:
          type:
            - string
            - 'null'
          format: uuid
        unit_amount:
          type:
            - integer
            - 'null'
          minimum: 0
        currency:
          type:
            - string
            - 'null'
        capacity:
          type: integer
          minimum: 0
        reserved:
          type: integer
          minimum: 0
        available:
          type: integer
          minimum: 0
        status:
          enum:
            - available
            - limited
            - request_to_book
            - sold_out
            - unavailable
    ProductOfferOccurrence:
      type: object
      additionalProperties: false
      properties:
        object:
          const: occurrence
        id:
          type: string
          pattern: ^occ_
        starts_at:
          type: string
          format: date-time
        ends_at:
          type: string
          format: date-time
        title:
          type:
            - string
            - 'null'
        date_label:
          type:
            - string
            - 'null'
        session_label:
          type:
            - string
            - 'null'
        status:
          type: string
    ProductOfferTier:
      type:
        - object
        - 'null'
      additionalProperties: false
      properties:
        object:
          const: admission_tier
        id:
          type:
            - string
            - 'null'
          pattern: ^tier_
        slug:
          type:
            - string
            - 'null'
        name:
          type:
            - string
            - 'null'
    ProductOfferInventoryPool:
      type: object
      additionalProperties: false
      properties:
        object:
          const: inventory_pool
        id:
          type: string
          pattern: ^inv_
        status:
          type: string
  securitySchemes:
    SimplePayApiKey:
      type: http
      scheme: bearer

````