Contractors

Contractors directory

The public "Find contractors" directory: providers (Users and Organizations) grouped from the active-service pool, with the same filters as the services search (category, term, location radius). Ordering follows the underlying search — nearest first when latitude/longitude are given. liked reflects the caller's Liked-contractors set when signed in (always false when signed out).

get/contractors

Request

  • Base URL: https://api.purplegrain.com/api/v1
  • URL: https://api.purplegrain.com/api/v1/contractors
  • Auth: none declared

Query parameters

categorystring

Category name to filter on — a single, exact Category.name (see GET /categories). This is the only category filter; ids and multiple values are not accepted. An unknown name returns no results.

termstring

Free-text search over the underlying services.

latitudenumber
longitudenumber
radiusnumber

Metres; combined with latitude/longitude.

pageinteger
per_pageinteger

Response

Providers grouped from matching services.

Example response

{
  "data": [
    {
      "type": "contractor"
    }
  ]
}

Changes

No recorded changes to this operation across all 4 revisions of this API.