Databento Users API
The users API from Databento — 28 operation(s) for users.
The users API from Databento — 28 operation(s) for users.
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/databento-users-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
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: Databento OpenAPI specification Users API
version: 0.167.1
tags:
- name: users
paths:
/v0/users/me:
get:
tags:
- users
summary: Read Current User
operationId: read_current_user_v0_users_me_get
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UserResponse'
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'404':
description: If user not found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/name:
put:
tags:
- users
summary: Update Current User Name
operationId: update_current_user_name_v0_users_me_name_put
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserNameUpdate'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UserResponse'
'400':
description: If full name exceeds character limit of 255
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'404':
description: If user not found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/email_update_intent:
get:
tags:
- users
summary: Get Email Update Intent
operationId: get_email_update_intent_v0_users_me_email_update_intent_get
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'404':
description: If user not found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
post:
tags:
- users
summary: Create Email Update Intent
operationId: create_email_update_intent_v0_users_me_email_update_intent_post
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserUpdateNewEmail'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UserEmailUpdateIntent'
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'404':
description: If user not found
'409':
description: If the email already exists.
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- users
summary: Delete Email Update Intent
operationId: delete_email_update_intent_v0_users_me_email_update_intent_delete
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'404':
description: If user not found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/email_update:
get:
tags:
- users
summary: Get Email Update Intent Detail
operationId: get_email_update_intent_detail_v0_users_email_update_get
parameters:
- name: request_id
in: query
required: true
schema:
type: string
title: Request Id
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: If email update status is not `CONFIRMED`
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
put:
tags:
- users
summary: Update User Email
operationId: update_user_email_v0_users_email_update_put
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserEmailUpdateConfirm'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/password:
put:
tags:
- users
summary: Update Current User Password
operationId: update_current_user_password_v0_users_me_password_put
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserPasswordUpdate'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UserResponse'
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'404':
description: If user not found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/keys:
post:
tags:
- users
summary: Create Current User Key
operationId: create_current_user_key_v0_users_me_keys_post
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserApiKeyCreate'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DetailResponse'
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions, or if the maximum number of API keys would be exceeded
'400':
description: 'If key `name` validation fails '
'409':
description: If API key with the same `name` already exists
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
get:
tags:
- users
summary: Read Current User Keys
operationId: read_current_user_keys_v0_users_me_keys_get
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/UserApiKeyResponse'
title: Response Read Current User Keys V0 Users Me Keys Get
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'404':
description: If user not found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/keys/{name}:
get:
tags:
- users
summary: Read Current User Key By Name
operationId: read_current_user_key_by_name_v0_users_me_keys__name__get
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: name
in: path
required: true
schema:
type: string
title: Name
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UserApiKeyResponse'
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'404':
description: If user or API key not found
'422':
description: If `name` validation fails
put:
tags:
- users
summary: Update Current User Key By Name
operationId: update_current_user_key_by_name_v0_users_me_keys__name__put
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: name
in: path
required: true
schema:
type: string
title: Name
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserApiKeyUpdate'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DetailResponse'
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'404':
description: If user or API key not found
'422':
description: If `name` validation fails
delete:
tags:
- users
summary: Delete Current User Key By Name
operationId: delete_current_user_key_by_name_v0_users_me_keys__name__delete
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: name
in: path
required: true
schema:
type: string
title: Name
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DetailResponse'
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'404':
description: If user or API key not found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/keys/{name}/rotate:
put:
tags:
- users
summary: Rotate Current User Key By Name
operationId: rotate_current_user_key_by_name_v0_users_me_keys__name__rotate_put
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: name
in: path
required: true
schema:
type: string
title: Name
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DetailResponse'
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'404':
description: If user or API key not found
'422':
description: If `name` validation fails
/v0/users/me/settings:
get:
tags:
- users
summary: List Settings
operationId: list_settings_v0_users_me_settings_get
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UserSettingsView'
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
put:
tags:
- users
summary: Update Settings
operationId: update_settings_v0_users_me_settings_put
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserSettingsUpdate'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/tutorials:
get:
tags:
- users
summary: List Tutorials
operationId: list_tutorials_v0_users_me_tutorials_get
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/tutorials/{tutorial_id}/completed:
post:
tags:
- users
summary: Update Tutorial Completed
operationId: update_tutorial_completed_v0_users_me_tutorials__tutorial_id__completed_post
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: tutorial_id
in: path
required: true
schema:
type: string
title: Tutorial Id
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/billing:
post:
tags:
- users
summary: Billing Capture
operationId: billing_capture_v0_users_me_billing_post
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/StripeSetupIntent'
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/add_card:
post:
tags:
- users
summary: Add Payment Card
operationId: add_payment_card_v0_users_me_add_card_post
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: payment_method
in: query
required: true
schema:
type: string
title: Payment Method
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema:
title: Response Add Payment Card V0 Users Me Add Card Post
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/update_default:
post:
tags:
- users
summary: Update Default
operationId: update_default_v0_users_me_update_default_post
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PaymentMethod'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DetailResponse'
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/edit_card:
post:
tags:
- users
summary: Edit Card
operationId: edit_card_v0_users_me_edit_card_post
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CardEdit'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DetailResponse'
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/list_cards:
get:
tags:
- users
summary: List Cards
operationId: list_cards_v0_users_me_list_cards_get
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Card'
title: Response List Cards V0 Users Me List Cards Get
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/delete_card:
post:
tags:
- users
summary: Delete Card
operationId: delete_card_v0_users_me_delete_card_post
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PaymentMethod'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
title: Response Delete Card V0 Users Me Delete Card Post
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/cart:
post:
tags:
- users
summary: Save Cart
operationId: save_cart_v0_users_me_cart_post
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserCart'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'401':
description: If user authentication fails
'403':
description: If user does not have sufficient permissions
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
get:
tags:
- users
summary: Read Cart
operationId: read_cart_v0_users_me_cart_get
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'401':
description: If user authentication fails
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/notifications:
get:
tags:
- users
summary: Read Notifications
operationId: read_notifications_v0_users_me_notifications_get
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'401':
description: If user authentication fails
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/notifications/read:
post:
tags:
- users
summary: Read And Update Notifications
operationId: read_and_update_notifications_v0_users_me_notifications_read_post
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'401':
description: If user authentication fails
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/notifications/mark_as_read:
post:
tags:
- users
summary: Mark Notifications As Read
operationId: mark_notifications_as_read_v0_users_me_notifications_mark_as_read_post
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/NotificationMsgIds'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'401':
description: If user authentication fails
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/notifications/has_unread:
get:
tags:
- users
summary: Has Unread Notifications
operationId: has_unread_notifications_v0_users_me_notifications_has_unread_get
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'401':
description: If user authentication fails
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/notifications/clear:
post:
tags:
- users
summary: Clear Notifications
operationId: clear_notifications_v0_users_me_notifications_clear_post
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'401':
description: If user authentication fails
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/alerts:
get:
tags:
- users
summary: Get Alert Messages
operationId: get_alert_messages_v0_users_me_alerts_get
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'401':
description: If user authentication fails
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v0/users/me/alerts/dismissed/{msg_id}:
put:
tags:
- users
summary: Dismiss An Alert Message
operationId: dismiss_an_alert_message_v0_users_me_alerts_dismissed__msg_id__put
security:
- OAuth2PasswordBearerWithCookie: []
parameters:
- name: msg_id
in: path
required: true
schema:
type: string
title: Msg Id
- name: retry
in: query
required: false
schema:
type: integer
default: 0
title: Retry
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'401':
description: If user authentication fails
'403':
description: If the alert message cannot be dismissed
'404':
description: If the alert message is not found
'422':
description: Validation Error
content:
application/json:
# --- truncated at 32 KB (44 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/databento/refs/heads/main/openapi/databento-users-api-openapi.yml