Skip to main content
Returns all products and services in the organization’s catalog. Supports optional filtering by description, SKU, or product key.

​
Authentication

Requires a valid Bearer token. The authenticated user must be a member of the organization.

​
Path Parameters

ParameterTypeRequiredDescription
organizationIdstring (UUID)YesOrganization ID

​
Query Parameters

ParameterTypeRequiredDescription
descriptionstringNoFilter by description (partial, case-insensitive)
skustringNoFilter by SKU (partial, case-insensitive)
productKeyintegerNoFilter by SAT product key (exact match)

​
Example Request

curl http://localhost:3001/api/organizations/550e8400-e29b-41d4-a716-446655440000/products?description=Ukelele \
  -H "Authorization: Bearer <your_token>"

​
Example Response

[
  {
    "id": "590ce6c56d04f840aa8438af",
    "organizationId": "550e8400-e29b-41d4-a716-446655440000",
    "livemode": true,
    "description": "Ukelele",
    "productKey": 60131324,
    "price": 345.6,
    "taxIncluded": true,
    "taxability": "01",
    "taxes": [{ "type": "IVA", "rate": 0.16 }],
    "localTaxes": [],
    "unitKey": "H87",
    "unitName": "Elemento",
    "sku": "UKL-001",
    "createdAt": "2025-01-26T10:00:00Z",
    "updatedAt": "2025-01-26T10:00:00Z"
  }
]