# Resolve the registered public subscription URL



Operation: resolveCalendarSubscription
GET /calendars/{surface}

Access: anonymous. Automatic retries: none. Redirects: manual. Request body limit: 0 bytes.
Default timeout: 30 seconds. Response limit: 16 MiB. Pagination is opt-in and bounded; an exhausted bound reports incomplete execution.

[HTML reference](/developers/api/resolveCalendarSubscription) · [Authoritative schemas](/api/openapi.json)

## Wire contract

```json
{
  "operationId": "resolveCalendarSubscription",
  "summary": "Resolve the registered public subscription URL",
  "tags": [
    "calendars"
  ],
  "parameters": [
    {
      "name": "surface",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "enum": [
          "activities",
          "books",
          "code",
          "concerts",
          "events",
          "movies",
          "music",
          "photos",
          "places",
          "podcasts",
          "reading",
          "sports",
          "tweets",
          "videos",
          "work",
          "writing",
          "feed"
        ]
      }
    }
  ],
  "responses": {
    "302": {
      "description": "Subscription URL; inspect with redirects disabled",
      "headers": {
        "Location": {
          "schema": {
            "type": "string",
            "format": "uri"
          }
        }
      }
    },
    "404": {
      "description": "Unknown or unregistered calendar",
      "content": {
        "text/plain": {
          "schema": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

## Synthetic examples

### curl

```bash
curl --fail-with-body --max-time 30 --max-filesize 16777216 --request GET 'https://irvinebroque.com/calendars/activities'
```

### TypeScript

```typescript
import { PublicApi } from '@irvinebroque/public-api';
const api = new PublicApi();
const result = await api.calendars.resolve({
  "surface": "activities"
});
console.log(result.status, result.headers.get('content-type')); // Keep transient capabilities in memory.
```

### CLI

```bash
irvinebroque calendars resolve --surface 'activities'
```