---
title: "Identify the caller and summarise the organization"
method: GET
path: "/v1/me"
tags: ["discovery"]
---

# Identify the caller and summarise the organization

`GET /v1/me`

## Request

- Base URL: `https://postbag.dev`
- URL: `https://postbag.dev/v1/me`
- Auth: HTTP bearer

The first call an agent holding only an API key should make: who it is, which org, which scopes the key has, plan limits and usage, and what already exists (counts). Call this before anything else.

## Response `200`

ok

- object
  - `organization` object, required
    - `id` string, required
    - `slug` string, required
    - `name` string, required
    - `plan` string, required
    - `plan_source` string, required
    - `plan_expires_at` string, nullable, required
    - `plan_note` string, nullable, required
    - `timezone` string, required
  - `key` object, required
    - `prefix` string
    - `scopes` string[], required
  - `organizations` OrganizationSummary[], required
    - `id` string, required
    - `slug` string, required
    - `name` string, required
    - `role` 'owner' | 'admin' | 'member' | 'null', nullable, required: The caller's role in this organization. Null when the caller is an API key — keys are org-scoped, not user-scoped, so they have no membership role of their own.
    - `is_active` boolean, required
  - `counts` object, required
    - `projects` integer, required
    - `forms` integer, required
    - `streams` integer, required
    - `destinations` integer, required
    - `routes` integer, required
  - `limits` object, required
    - `forms` integer, required
    - `submissions_per_month` integer, required
    - `destinations` integer, required
    - `retention_days` integer, required
    - `attachment_max_bytes` integer, required
    - `attachments_per_submission` integer, required
    - `attachment_storage_bytes` integer, required
    - `used` object, required
      - `forms` integer, required
      - `submissions_this_month` integer, required
      - `attachment_storage_bytes` integer, required
  - `next` object[], required
    - `why` string
    - `method` string
    - `path` string
    - `body` object

---

[API](https://skmtc.dev/postbag/apis/postbag-api.md) · [All operations](https://skmtc.dev/postbag/apis/postbag-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postbag/apis/postbag-api/revisions/3da976524695?raw)