---
title: "List one provider's service listings"
method: GET
path: "/services"
tags: ["Services"]
---

# List one provider's service listings

`GET /services`

## Request

- Base URL: `https://api.purplegrain.com/api/v1`
- URL: `https://api.purplegrain.com/api/v1/services`
- Auth: none declared

List agricultural service listings for `owner_id`. `owner_type` is `User` or `Organization` and defaults to a user; any other value is treated as a user. Without `owner_id` the result is empty. Optional filter[id][] and filter[status][] narrow that owner's listings. Returns descriptions, advertised costs, currencies, tags and image URLs; include expands supported owner, category and place details. Use page and per_page, following meta.next_page. This lookup does not book or change services.

## Query parameters

- `page` integer
- `per_page` integer
- `owner_id` string
- `owner_type` string
- `filter[id][]` string[]
- `filter[status][]` string[]
- `include` string

## Response `200`

Success. When the `include` query parameter is used, the response may contain an `included` array (JSON:API) or inlined related resources (application/json).

- ServicesIndexResponseAttributes
  - `data` ServiceModelAttributes[]
    - `id` string
    - `type` string
    - `slug` string
    - `name` string
    - `status` 'active' | 'inactive'
    - `cost` string, nullable
    - `currency` string, nullable
    - `description` string, nullable
    - `tags` string[]: Hashtag-style labels (they work like Twitter hashtags) — free-form lowercase tokens stored without a leading hash, e.g. ["slashing", "north-paddock"]. Reusing a tag groups records together, and the /tasks/search and /services/search term parameter matches tags case-insensitively, so a tag aggregates everything labelled with it. Always an array — the API never returns null.
    - `radius` integer, nullable
    - `url` string
    - `image_url` string, nullable
    - `image_thumb_url` string, nullable
    - `updated_at` string, date-time
    - `created_at` string, date-time
    - `city` object: Inlined when include=city
    - `place` object: Inlined when include=place
    - `owner` object: Inlined when include=owner
    - `category` object: Inlined when include=category
    - `location` object: Inlined when include=location
  - `meta` PaginationMeta
    - `current_page` number
    - `next_page` number, nullable
    - `prev_page` number, nullable

---

[API](https://skmtc.dev/purplegrain/apis/purple-grain-api.md) · [All operations](https://skmtc.dev/purplegrain/apis/purple-grain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/purplegrain/apis/purple-grain-api/revisions/4bedbc1c784c?raw)