Discovery needs no key. Ratings and market analysis are Pro.
Get an API 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.
openapi: 3.2.0
info:
title: Bankday Today API
version: 1.0.0
description: Business days, holidays and settlement dates for payment rails, exchanges and countries.
contact:
url: https://bankday.dev
servers:
- url: https://bankday.dev
security:
- bearer: []
tags:
- name: Today
paths:
/v1/today:
get:
operationId: today
summary: Today's status in the calendar's time zone
description: Same as business-day for the current date in the calendar's local time zone (e.g. America/New_York for us-fed), plus the next five holidays within 120 days.
parameters:
- name: calendar
in: query
required: true
description: Calendar id, or up to 10 comma-separated ids for a joint calendar (e.g. us-fed,eu-target2). Aliases such as nyse, ach, sepa, bacs are accepted.
schema:
type: string
- name: timezone
in: query
required: false
description: Optional IANA time zone overriding the calendar's own (default UTC for country calendars).
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
'400':
$ref: '#/components/responses/Error'
'401':
$ref: '#/components/responses/Error'
'404':
$ref: '#/components/responses/Error'
'422':
$ref: '#/components/responses/Error'
'429':
$ref: '#/components/responses/Error'
tags:
- Today
components:
responses:
Error:
description: Error
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
securitySchemes:
bearer:
type: http
scheme: bearer