# List organization camps

> Same as GET /v1/{metro}/camps?organization_id={id}, addressed by the organization instead of the metro.

Source: https://api.tailend.dev/docs/api/list-organization-camps

```http
GET https://api.tailend.dev/v1/organizations/{id}/camps
X-API-Key: $TAILEND_API_KEY
```

Same as `GET /v1/{metro}/camps?organization_id={id}`, addressed by the organization instead of the metro.

Resolves the organization by id, `404`s if it does not exist, and takes the metro from that row. An organization with live listings in more than one metro is a `400` asking for `metro=` to disambiguate, exactly like a slug that is not unique across the key's metros; give it and the ambiguity is resolved the same way. Every other list parameter keeps working. Same auth, metro scope, rate limiting and metering as the list endpoint; a key without access to the organization's metro gets the same `403` the list endpoint gives.

Authorization: send your key in the `X-API-Key` header. Available on every plan.

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string (uuid) | yes | Listing id. |

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `metro` | string | no | Which metro's row is meant, when a slug is not unique across the key's metros. |
| `from` | string (date) | no | Local calendar date (metro timezone), inclusive. |
| `to` | string (date) | no | Local calendar date (metro timezone), inclusive; at most 366 days after from. |
| `min_confidence` | number | no | Drop rows whose confidence is below this. |
| `category` | array of string | no | Keep rows whose categories contain any of these. |
| `audience` | array of string | no | Keep rows whose audience is one of these. |
| `season` | array of string | no | Events, classes and camps only. |
| `age` | integer | no | A child's age in years. |
| `neighborhood` | string | no | Neighborhood slug or free-text name (case-insensitive). |
| `lat` | number | no | Center latitude for a radius search. |
| `lng` | number | no | Center longitude for a radius search. |
| `radius_m` | integer | no | Radius in metres around lat/lng (or near_zip, where enabled). |
| `zip` | array of string | no | Beta — may not be enabled for all keys yet. |
| `near_zip` | string | no | Beta — may not be enabled for all keys yet. |
| `include_approximate` | boolean | no | Beta — may not be enabled for all keys yet. |
| `place_id` | string (uuid) | no | Keep rows held at this place (place.id). |
| `free` | boolean | no | Events, classes, and camps only; ignored for places. |
| `year` | integer | no | The camp's year. |
| `overnight` | boolean | no | Keep only overnight camps. |
| `changed_since` | string (date-time) | no | Sync mode. |
| `q` | string | no | Full-text search over the listing's name and search text (websearch syntax: storytime park, "drop in", art -camp). |
| `max_price` | number | no | A budget. |
| `fields` | array of string | no | Keep only these dotted paths on each item (name,place.name,price.is_free); id and type are always kept so a trimmed item stays addressable. |
| `expand` | array of string | no | Attach the full Place and/or the Organization behind each item under expanded, one extra read per expansion per page (not per row). |
| `include` | array of string | no | Opt into a block the lean default response leaves out. |
| `include_mode` | string | no | How an include= the key is not entitled to is handled. |
| `cursor` | string | no | Opaque cursor from meta.next_cursor. |
| `page` | integer | no | 1-based page number (browse mode). |
| `facets` | array of string | no | Counts over every listing that matches the filters, not just this page, returned as a top-level facets object beside data and meta. |
| `limit` | integer | no | Items per page, 1 to 200. |

## Example request

```bash
curl -sS \
  -H "X-API-Key: $TAILEND_API_KEY" \
  "https://api.tailend.dev/v1/organizations/7fb56a77-8603-4c31-a07f-ef9d9e7f53e3/camps"
```

## Responses

### 200

A page of camps.

```json
{
  "data": [
    {
      "id": "7fb56a77-8603-4c31-a07f-ef9d9e7f53e3",
      "type": "camp",
      "slug": "2026-summer-circus-camp-e49f4a3a",
      "name": "2026 Summer Circus Camp",
      "description": "The Philadelphia School of Circus Arts – Best of Philly Winner for “Kids Classes” – announces Summer Circus Camp 2026 for youth ages 4 – 15. Circus Camp returns with our 1-week camp program designed for campers with an emphasis on play and exploration in the exciting world of circus. Campers will learn static trapeze, aerial sling, aerial fabric, wire walking, juggling, plate-spinning, rolling globe, tumbling, unicycling, clowning and more. We can’t wait to share the excitement and challenge of the circus with kids in our full-day program!",
      "season": "summer",
      "year": 2026,
      "starts_on": "2026-06-01",
      "ends_on": "2026-06-05",
      "schedule": {
        "type": null,
        "is_full_day": true,
        "is_half_day_am": false,
        "is_half_day_pm": false,
        "day_start_time": "09:00:00",
        "day_end_time": "15:00:00",
        "extended_care": {
          "morning_start": null,
          "morning_price": null,
          "afternoon_end": null,
          "afternoon_price": null,
          "notes": "Before Care: $20/day; After Care: $35/day",
          "currency": "USD"
        },
        "timezone": "America/New_York"
      },
      "is_overnight": false,
      "is_travel": false,
      "is_specialty": false,
      "pricing_unit": "per_week",
      "price": {
        "type": "fixed",
        "min": 495,
        "max": 495,
        "scope": "admission",
        "note": "$495/week",
        "unit": "per_session",
        "is_free": false,
        "currency": "USD"
      },
      "ages": {
        "min": 4,
        "max": 15,
        "text": null,
        "audience": null,
        "bands": [
          "young_kids",
          "bigger_kids"
        ]
      },
      "audience": "teens",
      "traits": {
        "seasons": [
          "summer"
        ]
      },
      "place": {
        "id": "1730e947-3dd8-45ad-88f5-2fe7cdeec9e8",
        "slug": "philadelphia-school-of-circus-arts-62377244",
        "name": "Philadelphia School of Circus Arts"
      },
      "location": {
        "address": "6452 Greene Street",
        "street_address": "6452 Greene Street",
        "city": "Philadelphia",
        "state": "PA",
        "zip": "19119",
        "lat": 40.0419162,
        "lng": -75.1896032,
        "neighborhood": "Northwest Philadelphia",
        "neighborhood_slug": null
      },
      "categories": [
        "sports_active_play"
      ],
      "registration": {
        "url": "https://portal.iclasspro.com/phillycircus/booking",
        "opens_on": null,
        "deadline_on": null,
        "early_bird_deadline_on": null,
        "has_spots_available": true,
        "sessions_with_spots": 1
      },
      "sessions": [
        {
          "id": "4fbe88ce-c939-450e-92a0-e92c3f04ed6c",
          "name": "Summer Circus Camp 2026",
          "starts_on": "2026-06-01",
          "ends_on": "2026-06-05",
          "price": 495,
          "early_bird_price": null,
          "full_day_price": null,
          "half_day_price": null,
          "currency": "USD",
          "capacity": null,
          "spots_remaining": null,
          "status": "open",
          "theme": null,
          "notes": null
        }
      ],
      "image_url": "https://phillycircus.com/wp-content/uploads/PSCA-web-promo-01.jpg",
      "organization": {
        "id": "c6e39d31-abce-43f8-bccd-2cf5ce73a0ad",
        "name": "Philadelphia School of Circus Arts",
        "slug": "philadelphia-school-of-circus-arts"
      },
      "confidence": 0.55,
      "verified_at": null,
      "metro": "philadelphia",
      "status": "published",
      "created_at": "2026-09-22T06:11:27.636Z",
      "updated_at": "2026-09-26T08:19:23.038Z",
      "links": {
        "self": "/v1/camps/7fb56a77-8603-4c31-a07f-ef9d9e7f53e3",
        "place": "/v1/places/1730e947-3dd8-45ad-88f5-2fe7cdeec9e8",
        "organization": "/v1/organizations/c6e39d31-abce-43f8-bccd-2cf5ce73a0ad"
      }
    }
  ],
  "meta": {
    "limit": 1,
    "count": 1,
    "has_more": false,
    "applied_filters": {
      "from": "2026-09-14",
      "to": null,
      "min_confidence": 0.7,
      "audience": [
        "not_adults"
      ]
    },
    "defaults_applied": [
      "from",
      "min_confidence",
      "audience"
    ]
  }
}
```

### 400

Malformed or contradictory parameters (lat without lng, to before from, unknown category), or a cursor this API did not issue for this exact request — replayed from another endpoint, resource, metro or filter set, hand-crafted, or altered.

```json
{
  "error": {
    "code": "bad_request",
    "message": "radius_m: must be at least 100",
    "details": {
      "param": "radius_m"
    },
    "request_id": "req_dfbc3295a8382b05"
  }
}
```

### 401

Missing, unknown or revoked X-API-Key.

```json
{
  "error": {
    "code": "unauthorized",
    "message": "missing X-API-Key header",
    "request_id": "req_90e63908273f6bff"
  }
}
```

### 403

Two different reasons share this status.

```json
{
  "error": {
    "code": "forbidden",
    "message": "key is not scoped to metro 'boston'",
    "details": {
      "metros": [
        "philadelphia"
      ]
    },
    "request_id": "req_9e7a750acef48ab2"
  }
}
```

### 404

No published, active resource with that id (or unknown metro).

```json
{
  "error": {
    "code": "not_found",
    "message": "unknown metro 'boston'",
    "request_id": "req_7431b51e10ec2b77"
  }
}
```

### 405

The path exists; the method does not.

```json
{
  "error": {
    "code": "method_not_allowed",
    "message": "POST is not allowed on this path; this API is read-only",
    "details": {
      "allow": [
        "GET",
        "HEAD",
        "OPTIONS"
      ]
    },
    "request_id": "req_01J9Z3"
  }
}
```

### 429

A limit was reached.

```json
{
  "error": {
    "code": "rate_limited",
    "message": "3 requests per minute exceeded",
    "request_id": "req_06bfd3c2d5e8aa9f"
  }
}
```

### 500

A bug on our side.

```json
{
  "error": {
    "code": "internal",
    "message": "internal error",
    "request_id": "req_01J9Z3"
  }
}
```

### 501

This endpoint or feature is not available and will not become available without a configuration change — for ?address=, this means no geocoder is configured.

```json
{
  "error": {
    "code": "not_implemented",
    "message": "this endpoint is not enabled on this deployment; it is not a fault and retrying will not help",
    "request_id": "req_01J9Z3"
  }
}
```

### 503

A transient outage: a dependency could not be reached or did not answer in time.

```json
{
  "error": {
    "code": "unavailable",
    "message": "the service is temporarily unable to serve this request; retry after the interval in Retry-After",
    "request_id": "req_01J9Z3"
  }
}
```