---
title: "List APPROVED partners for the public directory"
method: GET
path: "/v1/partners"
tags: ["Public Partners"]
---

# List APPROVED partners for the public directory

`GET /v1/partners`

## Query parameters

- `page` number
- `pageSize` number
- `q` string
- `tier` 'NONE' | 'FRIEND' | 'PARTNER_PENDING' | 'PARTNER'
- `countryCode` string

## Response `200`

- PagedPartnerPublicDto
  - `items` PartnerPublicDto[], required
    - `id` string, uuid, required
    - `slug` string, required
    - `displayName` string, required
    - `description` string, nullable, required
    - `websiteUrl` string, nullable, required
    - `githubOrg` string, nullable, required
    - `logoUrl` string, nullable, required
    - `tier` 'NONE' | 'FRIEND' | 'PARTNER_PENDING' | 'PARTNER', required
    - `countryCode` string, nullable, required
    - `city` string, nullable, required
    - `technologyTags` string[], required
    - `businessVxp` number, required — Aggregate business VXP
    - `enthusiastCount` number, required
    - `developerCount` number, required
    - `partnerSince` string, date-time, nullable, required — When the partner was promoted to PARTNER tier (null if not yet promoted)
  - `total` number, required — Total number of items matching the query
  - `page` number, required — Current page (1-based)
  - `pageSize` number, required — Items per page

## Other responses

- `400` — Validation failed
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `409` — Conflict
- `500` — Internal server error

---

[API](https://skmtc.net/vendure/apis/vendure-io-api-public.md) · [All operations](https://skmtc.net/vendure/apis/vendure-io-api-public/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vendure/vendure-io-api-public/revisions/5fc4757128af/schema)