GET General Listing

Returns a lightweight reference list for one whitelisted model as a flat map of id → title. Handy for populating dropdowns and lookups.

Authentication: this endpoint uses the apikey header only (send your account API key). The Authorization: Bearer token is not used here.

Response shape: data.Listing is a flat object whose keys are record ids and whose values are the record titles (plain strings). There is no pagination, sorting, or free-text search.

Allowed model values (case-sensitive):

Model	Returns
`Category`	Categories, `id` → name
`InvoiceLayout`	Invoice layouts, `id` → name
`GroupPrice`	Price lists, `id` → name
`Role`	Staff roles, `id` → name
`Timezone`	Time zones, `id` → label
`Language`	Active languages, `id` → `Name (CODE)`
`Project`	Active projects, `id` → name
`TimeActivity`	Active time activities, `id` → name
`DateFormats`	Available date-format strings

Any value outside this list returns 404 Invalid Endpoint.

Optional filtering (honored only by Category, InvoiceLayout, GroupPrice, and Role; ignored by the other models):

fields — an array of exactly two field names, [keyField, valueField], that overrides which columns are used as the map key and value. Sending any number of elements other than two returns 400 Bad Request.

conditions — a map of field: value filters applied to the query.

curl --location --globoff 'https://.daftara.com/api2/listing/Role' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer ' \ --header 'apikey: ' \ --header 'Content-Type: application/json'

Request

Responses