# Me endpoints

> The key and workspace behind a credential — the first call every integration should make. Every operation with parameters, body, responses, errors and examples.

Source: https://developers.processcart.com/reference/me

The key and workspace behind a credential — the first call every integration should make.

Base URL `https://app.processcart.com/api/v1`. Every operation below is also in the [OpenAPI document](https://developers.processcart.com/openapi.json) and the [interactive reference](https://developers.processcart.com/reference).

| Operation | Method and path | Scope |
| --- | --- | --- |
| [Identify the API key and its workspace](#getMe) | <code class="pc-docs-wrap">GET /v1<wbr>/me</code> | Any valid key |

## GET /v1/me
**Identify the API key and its workspace.** Any valid key. Operation id `getMe` · [open in the API reference](https://developers.processcart.com/reference#tag/me/GET/v1/me).

Returns the organization (workspace) and the API key behind the credential, with the key's scopes and the published rate limit. `org.labels` lists the workspace's status labels — the ids a run's `labels`, the runs filter and automation rules take. Any valid key may call it — the first request every integration should make.

**Responses**

| Status | Meaning | Body |
| --- | --- | --- |
| 200 | OK. | [Me](https://developers.processcart.com/reference/schemas#me) |
| 401 | No usable credential. `unauthorized` — Authentication required; `invalid_api_key` — Invalid API key; `key_revoked` — API key revoked. | [Problem](https://developers.processcart.com/errors) |
| 405 | The verb is not supported on this path. `method_not_allowed` — Method not allowed. | [Problem](https://developers.processcart.com/errors) |
| 422 | `validation_failed` — Validation failed. | [Problem](https://developers.processcart.com/errors) |
| 429 | `rate_limited` — Too many requests. | [Problem](https://developers.processcart.com/errors) |
| 500 | `internal_error` — Internal error. | [Problem](https://developers.processcart.com/errors) |
| 503 | `unavailable` — Service unavailable. | [Problem](https://developers.processcart.com/errors) |

**Errors** (every code this operation can answer; see [Errors](https://developers.processcart.com/errors))

- 401 [`invalid_api_key`](https://developers.processcart.com/errors#invalid_api_key) — Invalid API key
- 401 [`key_revoked`](https://developers.processcart.com/errors#key_revoked) — API key revoked
- 401 [`unauthorized`](https://developers.processcart.com/errors#unauthorized) — Authentication required
- 405 [`method_not_allowed`](https://developers.processcart.com/errors#method_not_allowed) — Method not allowed
- 422 [`validation_failed`](https://developers.processcart.com/errors#validation_failed) — Validation failed
- 429 [`rate_limited`](https://developers.processcart.com/errors#rate_limited) — Too many requests
- 500 [`internal_error`](https://developers.processcart.com/errors#internal_error) — Internal error
- 503 [`unavailable`](https://developers.processcart.com/errors#unavailable) — Service unavailable

**Example response** (200)

```json
{
  "org": {
    "id": "8602787e-fdb1-4a7e-982f-09ea5b3005cd",
    "name": "Example workspace",
    "slug": "example-workspace",
    "timezone": "America/Los_Angeles",
    "sandbox": false,
    "labels": [
      {
        "id": "rush",
        "name": "Rush",
        "color": "#dc2626"
      },
      {
        "id": "waiting",
        "name": "Waiting",
        "color": "#f59e0b"
      }
    ]
  },
  "key": {
    "id": "07ea300f-832f-4f75-8859-0c318deec6b1",
    "name": "Example key",
    "prefix": "pc_live_ynpQ",
    "readOnly": false,
    "scopes": [
      "*"
    ],
    "createdAt": "2026-10-13T00:39:13.702Z",
    "lastUsedAt": null
  },
  "rateLimit": {
    "limit": 600,
    "windowSeconds": 60
  }
}
```