---
title: "List all partnerships"
method: GET
path: "/v2/partnerships"
tags: ["Partnerships"]
---

# List all partnerships

`GET /v2/partnerships`

Returns a list of partnerships you manage or are owned by you. The partnerships are returned sorted by creation date by default, with the most recent partnerships appearing first.

## Query parameters

- `order_by` '-created_at' | 'created_at' | '-updated_at' | 'updated_at'
- `has_sub_id` 'true' | 'false' | 'null'
- `include_offers` boolean
- `include_archived` boolean
- `limit` integer
- `starting_after` string
- `ending_before` string

## Response `200`

Returns a list of partnerships you manage or are owned by you. The partnerships are returned sorted by creation date by default, with the most recent partnerships appearing first.

- object
  - `data` object, required
    - `has_more` boolean
    - `items` object[]
      - `created_at` integer — Immutable Unix timestamp in milliseconds taken at time of creation
      - `key` string — A unique identifier used to reference the object
      - `updated_at` integer — Unix timestamp in milliseconds taken at time of last update
      - `claimed` boolean — Indicates whether or not the partnership has been claimed
      - `company` object — Base schema representation of a company
        - `key` string — Unique key of this company
        - `name` string — The name of this company
        - `id` integer, required — Unique id of this company
      - `has_sub_id` boolean, nullable — Indicates whether or not the program uses sub IDs
      - `offers` object[]
        - `base_rate` number, nullable
        - `currency` string, nullable
        - `description` string, nullable
        - `type` string, nullable
      - `status` 'active' | 'application-denied' | 'application-pending' | 'program-waitlisted' | 'removed' — Your status in this companies program. Can be one of: `active`, `application-denied`, `application-pending`, `program-waitlisted`, `removed`.
      - `link` object — Base schema representation of a link
        - `destination` string — The destination that this link redirects to
        - `key` string — Unique key of this link
        - `stack_key` string, nullable — The unique identifier for the teammate that owns the link
        - `url` string — The url that is shared for this link
      - `team` object
        - `key` string, nullable
        - `name` string, nullable
    - `total` integer, nullable
  - `message` string, required
  - `status` integer, required

## Other responses

- `400` — Bad Request Error
- `401` — Unauthorized Error
- `403` — Forbidden Error
- `404` — Not Found Error
- `500` — Internal Server Error

---

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