# People

> Read who an API key acts as, and list the members, teams and tags of your agency through the Fondaro API.

These routes tell you who a key acts as and give you the ids you need to assign leads, tasks and deals, and to tag leads. `GET /v1/me` needs no scope. The other three need `crm:read` and are open to every member as well as admins. None of them needs an active plan.

Each list is returned whole, as `{ "data": [...], "hasMore": false }`.

## Check who a key acts as

`GET /v1/me`

Returns the person, agency, role and key behind the credential. Any valid key with an owner can call it.

```bash
curl https://api.fondaro.com/v1/me \
  -H "Authorization: Bearer $FONDARO_API_KEY"
```

```json
{
  "user": { "id": "user_2abcDEF1234567890ghiJKL", "name": "Alex Morgan", "email": "alex@example.com" },
  "organization": { "id": "3f6c2a10-0000-4000-8000-000000000001", "name": "Example Realty" },
  "role": "admin",
  "entitled": true,
  "key": {
    "id": "3f6c2a10-0000-4000-8000-000000000014",
    "name": "Reporting script",
    "prefixHint": "fondaro_pk_***",
    "scopes": ["crm:read", "crm:write", "properties:read", "sources:read", "brochures:read", "brochures:write", "documents:read", "documents:write"],
    "expiresAt": "2026-11-03T13:01:47.714Z"
  }
}
```

`role` is `admin` or `member`. `entitled` is `false` when the agency has no active plan: CRM writes and every documents route answer `403` with `SUBSCRIPTION_REQUIRED`; reads and brochures still work.

## List members

`GET /v1/members`

The people in your agency, up to 100, so you can choose owners for a lead, task or deal. Their ids are the `userId` values.

```bash
curl https://api.fondaro.com/v1/members \
  -H "Authorization: Bearer $FONDARO_API_KEY"
```

```json
{
  "data": [
    {
      "userId": "user_2abcDEF1234567890ghiJKL",
      "firstName": "Alex",
      "lastName": "Morgan",
      "email": "alex@example.com",
      "imageUrl": "https://example.com/avatar.png",
      "role": "org:admin"
    }
  ],
  "hasMore": false
}
```

## List teams

`GET /v1/teams`

The agency's teams with their member ids. Archived teams are not listed. Pass a team id as `teamIds` on the owner fields of leads, tasks and deals to give something to the whole team.

```bash
curl https://api.fondaro.com/v1/teams \
  -H "Authorization: Bearer $FONDARO_API_KEY"
```

```json
{
  "data": [
    { "id": "3f6c2a10-0000-4000-8000-000000000015", "name": "Sales", "color": "red", "memberIds": ["user_2mnoPQR1234567890stuVWX"], "memberCount": 1 }
  ],
  "hasMore": false
}
```

## List tags

`GET /v1/tags`

The agency's tags with how many leads carry each. Use the ids with [Set the tags on a lead](https://www.fondaro.com/docs/api/v1/leads.md#set-the-tags-on-a-lead).

```bash
curl https://api.fondaro.com/v1/tags \
  -H "Authorization: Bearer $FONDARO_API_KEY"
```

```json
{
  "data": [
    {
      "id": "3f6c2a10-0000-4000-8000-000000000006",
      "name": "BrandNewTag",
      "color": "slate",
      "createdBy": "user_2abcDEF1234567890ghiJKL",
      "archivedAt": null,
      "assigneeIds": [],
      "teamIds": [],
      "createdAt": "2026-06-10T11:00:02.001Z",
      "updatedAt": "2026-06-10T11:00:02.001Z",
      "leadCount": 0
    }
  ],
  "hasMore": false
}
```

Source: https://www.fondaro.com/docs/api/v1/people