List price lists
GET/api/price-lists
Required permissions:
- pricelist.view: allows view resources of price lists.
Here the dedicated support page.
Request
Query Parameters
- On a date
- Greater than
- Lower than
Possible values: <= 100
Default value: 100
The number of items to include in the response.
Default value: 0
The offset of the first returned item.
Filter items by the updated_at field. This is in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
Filter items updated on a date.
Example: 2024-01-01T20:00:00%2B02:00
Filter items updated after a date.
Example: gt:2024-01-01T20:00:00%2B02:00
Filter items updated before a date.
Example: lt:2024-01-01T20:00:00%2B02:00
Header Parameters
The company you want to interact with
The API version you want to use
Responses
- 200
- 400
- 401
- 403
Returns the list of price lists.
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
Possible values: >= 1
The price list name
The price list description
The date from which the price list is available. This follows the YYYY-MM-DD format
The date until which the price list is available. This follows the YYYY-MM-DD format
Whether this is the default price list for the client
Whether this is the default price list for the company
Whether to sync costs with company default price list
Possible values: >= 1
ID of the client to associate with this employee
[
{
"id": 1,
"created_at": "2025-04-22T10:10:02.992Z",
"updated_at": "2025-04-22T10:10:02.992Z",
"name": "string",
"description": "string",
"available_from": "2025-04-22",
"available_to": "2025-04-22",
"is_default_for_client": true,
"is_default_for_company": true,
"uses_default_price_list_costs": true,
"client_id": 1
}
]
Validation failed
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
Error unique key
Human-readable message describing the error
failures
object[]
List of validation errors
Name of the field causing the error
Human-readable description of the error
{
"key": "invalid_data",
"message": "You provided invalid data. Check 'failures' for details.",
"failures": [
{
"field": "string",
"message": "string"
}
]
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
Error unique key
Human-readable message describing the error
{
"key": "string",
"message": "string"
}
Forbidden
- application/json
- Schema
- Example (from schema)
Schema
Error unique key
Human-readable message describing the error
{
"key": "string",
"message": "string"
}