Citation Sources API
The Sources API from Citation — 1 operation(s) for sources.
The Sources API from Citation — 1 operation(s) for sources.
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-sources-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 Sources 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: Sources
paths:
/sources/resolve:
post:
operationId: resolveJob
summary: resolve Job
description: Queue source lookup by DOI, ISBN, public HTTP or HTTPS URL, or search text with a required max_credits ceiling. The fixed cost is 1 credit. Poll the returned job_id and review the source candidates before saving them; an empty valid result can be a successful lookup.
parameters:
- name: Idempotency-Key
in: header
required: true
description: Reuse the same value and identical payload after a timeout. Different input returns 409. Retained across key rotation.
schema:
type: string
minLength: 1
maxLength: 128
security:
- apiKey: []
x-scopes:
- sources:read
x-credits: 1
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/resolve'
responses:
'202':
description: Credits reserved. Poll the returned job_id.
headers:
X-Request-ID:
schema:
type: string
format: uuid
content:
application/json:
schema:
$ref: '#/components/schemas/AcceptedJob'
'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:
- Sources
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
resolve:
type: object
properties:
query:
type: string
minLength: 1
maxLength: 2000
max_credits:
type: integer
minimum: 0
maximum: 100
required:
- query
- max_credits
additionalProperties: false
AcceptedJob:
type: object
properties:
job_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)$
status:
type: string
const: queued
credits:
type: integer
minimum: -9007199254740991
maximum: 9007199254740991
required:
- job_id
- status
- credits
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