Public Endpoints

Unauthenticated endpoints accessible without a Bearer token, intended for public-facing frontends.

These endpoints do not require authentication. Use the ?lang=en query parameter to receive translated fields in the desired language.

GET /api/v1.0/article-public

Returns a paginated list of publicly published articles, such as news, previews, and press releases.

Parameters

Parameter	Type	Description
`range`	integer	Number of results per page (default: 25)
`page`	integer	Page number (0-based)
`sort`	string	Field to sort by (e.g. `created`)
`filter[status]`	string	Filter by article status (e.g. `published`)
`lang`	string	Language code for translated fields (e.g. `en`, `fr`)

Example Request

GET /api/v1.0/article-public?range=25&page=0&lang=en

Response

{
  "data": [
    {
      "id": "1",
      "title": "Spring Auction Preview",
      "body": "...",
      "created": "2025-09-01T00:00:00Z"
    }
  ],
  "count": 42
}

GET /api/v1.0/catalogs-public

Returns a paginated list of publicly visible auction catalogs.

Parameters

Parameter	Type	Description
`range`	integer	Number of results per page (default: 25)
`page`	integer	Page number (0-based)
`lang`	string	Language code for translated fields (e.g. `en`, `fr`)

Example Request

GET /api/v1.0/catalogs-public?range=25&page=0&lang=en

Response

{
  "data": [
    {
      "id": "5",
      "name": "Spring 2025",
      "sale_id": "12"
    }
  ],
  "count": 10
}

GET /api/v1.0/catalogue-parts-public

Returns publicly visible parts (sections or chapters) within a given catalog.

Parameters

Parameter	Type	Description
`range`	integer	Number of results per page (default: 25)
`page`	integer	Page number (0-based)
`filter[catalog_id]`	string	Filter by catalog node ID
`lang`	string	Language code for translated fields (e.g. `en`, `fr`)

Example Request

GET /api/v1.0/catalogue-parts-public?filter[catalog_id]=5&lang=en

Response

{
  "data": [
    {
      "id": "3",
      "label": "Part A",
      "catalog_id": "5"
    }
  ],
  "count": 20
}

GET /api/v1.0/items-public

Returns a paginated list of publicly visible auction lots. Use filters to narrow results by sale or status.

Parameters

Parameter	Type	Description
`range`	integer	Number of results per page (default: 25)
`page`	integer	Page number (0-based)
`sort`	string	Field to sort by (e.g. `lot_number`)
`filter[sale_id]`	string	Filter by sale node ID
`filter[status]`	string	Filter by item status (e.g. `active`)
`lang`	string	Language code for translated fields (e.g. `en`, `fr`)

Example Request

GET /api/v1.0/items-public?filter[sale_id]=12&range=25&lang=en

Response

{
  "data": [
    {
      "id": "100",
      "title": "Baroque Oil Painting",
      "estimate_low": 5000,
      "estimate_high": 8000,
      "sale_id": "12",
      "lot_number": "15"
    }
  ],
  "count": 385
}

GET /api/v1.0/sales-public

Returns a paginated list of publicly visible auction sales.

Parameters

Parameter	Type	Description
`range`	integer	Number of results per page (default: 25)
`page`	integer	Page number (0-based)
`sort`	string	Field to sort by (e.g. `date`)
`filter[status]`	string	Filter by sale status (e.g. `upcoming`, `closed`)
`lang`	string	Language code for translated fields (e.g. `en`, `fr`)

Example Request

GET /api/v1.0/sales-public?filter[status]=upcoming&lang=en

Response

{
  "data": [
    {
      "id": "12",
      "title": "Spring Fine Art Auction",
      "date": "2025-11-15",
      "status": "upcoming"
    }
  ],
  "count": 6
}

GET /api/v1.0/tasks-public

Returns publicly visible event tasks such as viewing appointments, open days, and other scheduled activities associated with a sale.

Parameters

Parameter	Type	Description
`range`	integer	Number of results per page (default: 25)
`page`	integer	Page number (0-based)
`filter[sale_id]`	string	Filter tasks by sale node ID

Example Request

GET /api/v1.0/tasks-public?filter[sale_id]=12

Response

{
  "data": [
    {
      "id": "7",
      "title": "Public Viewing",
      "date": "2025-11-10",
      "location": "Main Gallery"
    }
  ],
  "count": 3
}