Use the Pinned Events OpenAPI schema to generate clients, inspect request and response contracts, and understand public API versioning.
Current version
The public endpoint namespace is /api/public/v1. The current generated schema is published as public-api-v1 and can be downloaded from the OpenAPI YAML URL.
OpenAPI YAML
curl https://pinned.events/api/developer/openapi/public-api-v1Use the OpenAPI file to generate clients, import into Postman or Insomnia, or validate request and response contracts in CI.
Breaking changes and deprecations
Breaking changes should use a new versioned namespace. Deprecated fields or behaviors are documented before removal when possible.
Client generation
Use the OpenAPI YAML with client generators or API tooling such as Postman and Insomnia. Generated clients should still keep API keys server-side and should not be bundled into frontend code with secrets.
Related pages
Getting startedCreate an API key, find a channelId, publish your first event, and retry safely.Create eventsCreate draft or published events with required fields first, then add location, media, ticketing, and publishing options.PaginationUnderstand pagination fields returned by list endpoints, including page, limit, totalDocs, totalPages, hasNextPage, and hasPrevPage.ErrorsUnderstand the error envelope, common status codes, and how to debug failed Public API requests.