---
title: "List providers"
method: GET
path: "/provider"
tags: ["Provider"]
---

# List providers

`GET /provider`

Get a paginated list of providers filtered by [NRN](/docs/NRN) and other queries

## Query parameters

- `limit` integer
- `offset` integer
- `id` string, uuid — Unique identifier for the entity represented as a UUID
- `nrn` string, required — Nullplatform Resource Name (NRN) representing a hierarchical identifier for nullplatform resources
- `dimensions` string — Dimensions for the query, formatted as key:value pairs separated by commas (e.g., "key1:value1,key2:value2")
- `specification_id` string
- `specification_slug` string
- `show_descendants` boolean
- `show_ascendants` boolean
- `specification` Def0[]
- `include` string[]

## Response `2XX`

Paginated list of providers

- object — Paginated list of providers
  - `paging` object, required
    - `limit` integer, required — Limits the number of results returned
    - `offset` integer, required — Specifies the offset for paginated results
  - `results` SchemasDef17[], required
    - `id` string, uuid, required — Unique identifier for the entity represented as a UUID
    - `nrn` string, required — Nullplatform Resource Name (NRN) representing a hierarchical identifier for nullplatform resources
    - `specification_id` string, uuid, required — Unique identifier for the entity represented as a UUID
    - `attributes` object, required — Provider-specific attributes defined in the specification schema
    - `dimensions` object — NRN-specific dimensions. [Read more](/docs/dimensions)
    - `tags` object[] — Tags associated with the provider
      - `key` string, required — Tag key
      - `value` string, required — Tag value
      - `id` string, uuid, required — Unique identifier for the entity represented as a UUID
    - `groups` string[] — Groups associated with the provider
    - `created_at` string, date-time, required — Creation timestamp
    - `updated_at` string, date-time, required — Last update timestamp

## Other responses

- `4XX` — Format for representing errors during API interactions
- `5XX` — Format for representing errors during API interactions

---

[API](https://skmtc.dev/nullplatform/apis/nullplatform-api.md) · [All operations](https://skmtc.dev/nullplatform/apis/nullplatform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nullplatform/nullplatform-api/revisions/1c4ea154b159/schema)