Citation Me API
The Me API from Citation — 1 operation(s) for me.
The Me API from Citation — 1 operation(s) for me.
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-me-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 Me 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: Me
paths:
/me:
get:
operationId: connection
summary: connection
description: Verify the API key and read its account, workspace, scopes, expiry and limits. This operation requires the same Bearer authentication as every API v1 operation.
parameters: []
security:
- apiKey: []
x-scopes: []
x-credits: 0
responses:
'200':
description: Successful operation.
headers:
X-Request-ID:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/Connection'
'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:
- Me
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
Connection:
type: object
properties:
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)$
user_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)$
workspace_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)$
scopes:
type: array
items:
type: string
enum:
- documents:read
- documents:write
- sources:read
- sources:write
- exports:read
- ai:write
- checks:write
- files:write
- sharing:read
- sharing:write
- comments:read
- comments:write
- webhooks:write
expires_at:
type: string
limits:
type: object
properties:
key_per_minute:
type: number
account_per_minute:
type: number
running_jobs:
type: number
queued_jobs:
type: number
ai_words:
type: number
ai_sources:
type: number
output_words:
type: number
check_words:
type: number
check_sources:
type: number
file_bytes:
type: number
required:
- key_per_minute
- account_per_minute
- running_jobs
- queued_jobs
- ai_words
- ai_sources
- output_words
- check_words
- check_sources
- file_bytes
required:
- id
- user_id
- workspace_id
- scopes
- expires_at
- limits
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