Citation Events API
The Events API from Citation — 1 operation(s) for events.
The Events API from Citation — 1 operation(s) for events.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/citation-co:citation-co-events-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Citation Events API
version: 1.0.0
description: Workspace scoped API keys, durable jobs and prepaid credits. AI and Check return proposals unless apply is true. Credit purchases are currently unavailable; operations that use credits require an existing balance.
servers:
- url: https://citation.co/api/v1
description: Citation production
security:
- apiKey: []
tags:
- name: Events
paths:
/events:
get:
operationId: events
summary: events
description: Read a cursor page of accessible document, source and job events in the key's workspace. Event payloads contain identifiers rather than document text. Save next_cursor after the downstream action succeeds.
parameters:
- name: after
in: query
required: false
schema:
type: string
pattern: ^\d+$
- name: limit
in: query
required: false
schema:
default: 20
type: integer
minimum: 1
maximum: 50
security:
- apiKey: []
x-scopes:
- documents:read
x-credits: 0
responses:
'200':
description: Successful operation.
headers:
X-Request-ID:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/EventsPage'
'400':
description: Invalid input
headers:
X-Request-ID:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Invalid key
headers:
X-Request-ID:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Insufficient credits
headers:
X-Request-ID:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Insufficient permissions
headers:
X-Request-ID:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Resource not found
headers:
X-Request-ID:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'408':
description: Request timeout
headers:
X-Request-ID:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'409':
description: Version or idempotency conflict
headers:
X-Request-ID:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'413':
description: Size limit
headers:
X-Request-ID:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'415':
description: Unsupported media
headers:
X-Request-ID:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'422':
description: Invalid content or credit ceiling
headers:
X-Request-ID:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate or queue limit
headers:
X-Request-ID:
schema:
type: string
Retry-After:
schema:
type: integer
description: Seconds to wait before retrying.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'502':
description: Invalid provider result
headers:
X-Request-ID:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: Temporarily unavailable
headers:
X-Request-ID:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
tags:
- Events
components:
schemas:
Error:
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
retryable:
type: boolean
request_id:
type: string
format: uuid
pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
required:
- code
- message
- retryable
- request_id
required:
- error
EventsPage:
type: object
properties:
items:
type: array
items:
type: object
properties:
id:
type: integer
minimum: -9007199254740991
maximum: 9007199254740991
type:
type: string
data:
type: object
propertyNames:
type: string
additionalProperties: {}
created_at:
type: string
required:
- id
- type
- data
- created_at
has_more:
type: boolean
next_cursor:
type:
- string
- number
- 'null'
required:
- items
- has_more
- next_cursor
securitySchemes:
apiKey:
type: http
scheme: bearer
bearerFormat: ca1_
externalDocs:
description: API reference and authentication
url: https://citation.co/docs/api
x-pricing:
currency: USD
package:
amount: 1000
credits: 100
operations:
write: 1
resolve: 1
import: 1
export: 1
check: 5
expires: false
x-limits:
key_per_minute: 120
account_per_minute: 300
running_jobs: 2
queued_jobs: 20
ai_words: 10000
ai_sources: 12
output_words: 2000
check_words: 5000
check_sources: 20
file_bytes: 10000000