Business-Day API

API ID 12996

Accurate business-day, holiday, and scheduling math for major countries and their subdivisions — without maintaining a single holiday calendar yourself. Add or subtract working days, check if a date is a business day, find the next valid date, or count working days between two dates, with full support for regional subdivisions, custom weekends, and your own blackout dates. One simple GET call, instant JSON.

203 ms resp. promedio

Documentación de la API

Endpoints

Solicitud

Checks whether a given date is a working business day for a country or region, accounting for weekends, public holidays, and any custom blackout dates you supply. Returns true or false. Supports regional subdivisions (e.g. US states, German Länder) and configurable weekend days for Friday/Saturday-weekend regions.

Endpoint ID: 26001
GET https://docs.zylalabs.com/api/12996/business-day+api/26001/is+business+day
PARÁMETROS DE ENTRADA

Is Business Day — Características del Endpoint

Objeto Descripción
date Requerido Date to check, ISO format YYYY-MM-DD (e.g. 2026-12-25)
region Requerido ISO country code, e.g. US, GB, DE, CA
weekend Opcional Optional weekend days, comma-separated Mon=0 to Sun=6. Default 5,6 (Sat/Sun). Use 4,5 for Friday/Saturday regions
extra_holidays Opcional Optional comma-separated ISO dates to treat as non-working days
subdiv Opcional Optional state/province/region code, e.g. CA for California or BY for Bavaria

Pruebas gratuitas restantes: 3 de 3.


PARÁMETROS DE ENTRADA

date
region
weekend
extra_holidays
subdiv
RESPUESTA DE EJEMPLO DE LA API
JSON
{"date":"2026-12-25","region":"US","is_business_day":false}
Is Business Day — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12996/business-day+api/26001/is+business+day?date=Required®ion=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud

Adds or subtracts a number of working business days to a date, skipping weekends, public holidays, and any custom blackout dates. Supports regional subdivisions and configurable weekends.

Endpoint ID: 26002
GET https://docs.zylalabs.com/api/12996/business-day+api/26002/add+business+days
PARÁMETROS DE ENTRADA

Add Business Days — Características del Endpoint

Objeto Descripción
date Requerido Date to check, ISO format YYYY-MM-DD (e.g. 2026-12-25)
days Requerido Number of business days to add. Use a negative number to subtract, e.g. 5 or -3
region Requerido ISO country code, e.g. US, GB, DE, CA
subdiv Opcional Optional state/province/region code, e.g. CA for California or BY for Bavaria
weekend Opcional Optional weekend days, comma-separated Mon=0 to Sun=6. Default 5,6 (Sat/Sun). Use 4,5 for Friday/Saturday regions
extra_holidays Opcional Optional comma-separated ISO dates to treat as non-working days, e.g. 2026-07-06

Pruebas gratuitas restantes: 3 de 3.


PARÁMETROS DE ENTRADA

date
days
region
subdiv
weekend
extra_holidays
RESPUESTA DE EJEMPLO DE LA API
JSON
{"start":"2026-07-02","days":5,"result":"2026-07-10"}
Add Business Days — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12996/business-day+api/26002/add+business+days?date=2026-07-02&days=5®ion=US' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud

Devuelve el primer día hábil laborable en o después de una fecha dada, omitiendo fines de semana, días festivos y fechas de bloqueo personalizadas. Establezca inclusive=true para permitir la fecha en sí si ya es un día laborable.

Endpoint ID: 26003
GET https://docs.zylalabs.com/api/12996/business-day+api/26003/next+business+day
PARÁMETROS DE ENTRADA

Próximo día hábil — Características del Endpoint

Objeto Descripción
date Requerido Date to check, ISO format YYYY-MM-DD (e.g. 2026-12-25)
region Requerido ISO country code, e.g. US, GB, DE, CA
inclusive Opcional Optional true or false. If true, returns the date itself when it is already a working day. Default false
subdiv Opcional Optional state/province/region code, e.g. CA for California or BY for Bavaria
weekend Opcional Optional weekend days, comma-separated Mon=0 to Sun=6. Default 5,6 (Sat/Sun). Use 4,5 for Friday/Saturday regions
extra_holidays Opcional Optional comma-separated ISO dates to treat as non-working days, e.g. 2026-07-06

Pruebas gratuitas restantes: 3 de 3.


PARÁMETROS DE ENTRADA

date
region
inclusive
subdiv
weekend
extra_holidays
RESPUESTA DE EJEMPLO DE LA API
JSON
{"from":"2026-07-02","result":"2026-07-06"}
Próximo día hábil — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12996/business-day+api/26003/next+business+day?date=2026-07-02®ion=US' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud

Counts the number of working business days between two dates, excluding weekends, public holidays, and custom blackout dates. Supports regional subdivisions and configurable weekends.

Endpoint ID: 26004
GET https://docs.zylalabs.com/api/12996/business-day+api/26004/business+days+between
PARÁMETROS DE ENTRADA

Business Days Between — Características del Endpoint

Objeto Descripción
start Requerido Start date in ISO format YYYY-MM-DD, e.g. 2026-07-01
end Requerido End date in ISO format YYYY-MM-DD, e.g. 2026-07-31
region Requerido ISO country code, e.g. US, GB, DE, CA
subdiv Opcional Optional state/province/region code, e.g. CA for California or BY for Bavaria
weekend Opcional Optional weekend days, comma-separated Mon=0 to Sun=6. Default 5,6 (Sat/Sun). Use 4,5 for Friday/Saturday regions
extra_holidays Opcional Optional comma-separated ISO dates to treat as non-working days, e.g. 2026-07-06

Pruebas gratuitas restantes: 3 de 3.


PARÁMETROS DE ENTRADA

start
end
region
subdiv
weekend
extra_holidays
RESPUESTA DE EJEMPLO DE LA API
JSON
{"start":"2026-07-01","end":"2026-07-31","business_days":21}
Business Days Between — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12996/business-day+api/26004/business+days+between?start=2026-07-01&end=2026-07-31®ion=US' --header 'Authorization: Bearer YOUR_API_KEY' 


    

Clave de Acceso a la API y Autenticación

Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Business-Day API simplemente incluye tu token de portador en el encabezado de Autorización.

Encabezados
Encabezado Descripción
Autorización Requerido Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.

Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.

(Ahorra 2 meses pagando anualmente 🎉)

🚀 PLAN CORPORATIVO A MEDIDA

Comienza en
$ 10.000/Año


  • Volumen Personalizado
  • Límite de solicitudes personalizado
  • Soporte al Cliente Especializado
  • Monitoreo de API en Tiempo Real

Resumen

Date arithmetic looks trivial until you cross a border. "Five business days from today" means something different in California than in Bavaria, observed-holiday rules shift weekends around, some regions don't even use a Saturday/Sunday weekend, and every customer has their own closures on top of the public calendar. Getting this wrong quietly breaks SLA clocks, delivery estimates, payment settlement windows, and appointment scheduling.

This API handles all of it behind one endpoint. Public holidays for over 100 countries and their subdivisions (US states, German Länder, Canadian provinces, and more) are kept current for you. On top of that you get the things a raw calendar can't do on its own: working-day arithmetic, configurable weekend days for non-Mon–Fri regions, and per-request custom holidays so a customer's own office closures fold into the calculation.

Built for logistics and delivery-date estimation, fintech settlement and payment scheduling, SLA and ticket-aging clocks, payroll, and any appointment or booking system that has to respect real working days. Responses are small, cacheable JSON and return in milliseconds.

Highlights

  • 100+ countries with regional subdivision support
  • Add / subtract business days, with correct observed-holiday handling
  • Check any date, find the next working day, or count working days in a range
  • Configurable weekends (e.g. Friday/Saturday regions)
  • Per-request custom holidays / blackout dates
  • Tiny JSON in, tiny JSON out — one GET call, no SDK required

Endpoint reference

All endpoints are GET. Dates are ISO YYYY-MM-DD. region is an ISO country code (e.g. US, GB, DE, CA). Optional params:

  • subdiv — state/province/region code (e.g. CA for California, BY for Bavaria)
  • weekend — comma-separated weekday numbers, Monday=0 … Sunday=6. Default 5,6 (Sat/Sun). Example: 4,5 for a Friday/Saturday weekend.
  • extra_holidays — comma-separated ISO dates to treat as non-working (a customer's own closures), merged with the public calendar.

1. Is business day — GET /v1/is-business-day

Returns whether a date is a working day (not a weekend, public holiday, or supplied blackout date).

Param Required Example
date yes 2026-12-25
region yes US
subdiv no CA
weekend no 5,6
extra_holidays no 2026-12-24

Request:

 
GET /v1/is-business-day?date=2026-12-25&region=US

Response:

 
json
{ "date": "2026-12-25", "region": "US", "is_business_day": false }

2. Add business days — GET /v1/add-business-days

Adds (or subtracts, if days is negative) N working days to a date.

Param Required Example
date yes 2026-07-02
days yes 5
region yes US
subdiv no CA
weekend no 5,6
extra_holidays no 2026-07-06

Request:

 
GET /v1/add-business-days?date=2026-07-02&days=5&region=US&subdiv=CA

Response:

 
json
{ "start": "2026-07-02", "days": 5, "result": "2026-07-10" }

(July 3 is the observed Independence Day holiday, plus two weekends, so five working days lands on July 10.)

3. Next business day — GET /v1/next-business-day

Returns the first working day after a date. Pass inclusive=true to allow the date itself if it is already a working day.

Param Required Example
date yes 2026-12-25
region yes US
inclusive no false
subdiv no CA
weekend no 5,6
extra_holidays no

Request:

 
GET /v1/next-business-day?date=2026-12-25&region=US

Response:

 
json
{ "from": "2026-12-25", "result": "2026-12-28" }

4. Business days between — GET /v1/business-days-between

Counts working days in the half-open interval (start, end]. Negative if end precedes start.

Param Required Example
start yes 2026-12-24
end yes 2026-12-31
region yes US
subdiv no CA
weekend no 5,6
extra_holidays no

Request:

 
GET /v1/business-days-between?start=2026-12-24&end=2026-12-31&region=US

Response:

 
json
{ "start": "2026-12-24", "end": "2026-12-31", "business_days": 4 }

Errors

  • 400 — bad input (malformed date, out-of-range weekend, unsupported region). Body: { "detail": "" }
  • 401 — missing or invalid key (handled by the marketplace layer).
  • 429 — rate limit exceeded.

International examples (demonstrate coverage, don't just claim it)

These show the regional parameters actually changing the result — the most credible thing a browsing developer can see. All values verified against the live calendars.

Subdivisions matter — same date, different answer

Epiphany (Jan 6, 2026, a Tuesday) is a public holiday in Bavaria but a normal working day in Berlin:

 
GET /v1/is-business-day?date=2026-01-06&region=DE&subdiv=BY
{ "date": "2026-01-06", "region": "DE", "is_business_day": false }

GET /v1/is-business-day?date=2026-01-06&region=DE&subdiv=BE
{ "date": "2026-01-06", "region": "DE", "is_business_day": true }

The arithmetic reflects it too — adding one working day to Wed June 3 skips Corpus Christi (Thu June 4) in Bavaria, but not in Berlin:

 
GET /v1/add-business-days?date=2026-06-03&days=1&region=DE&subdiv=BY
{ "start": "2026-06-03", "days": 1, "result": "2026-06-05" }

GET /v1/add-business-days?date=2026-06-03&days=1&region=DE&subdiv=BE
{ "start": "2026-06-03", "days": 1, "result": "2026-06-04" }

Non-Mon–Fri weekends

Egypt with a Friday/Saturday weekend — one working day after Thursday March 5 lands on Sunday March 8, not Friday:

 
GET /v1/add-business-days?date=2026-03-05&days=1&region=EG&weekend=4,5
{ "start": "2026-03-05", "days": 1, "result": "2026-03-08" }

GET /v1/next-business-day?date=2026-03-05&region=EG&weekend=4,5
{ "from": "2026-03-05", "result": "2026-03-08" }

Counting working days under a Friday/Saturday weekend (Saudi Arabia, Mar 1–8):

 
GET /v1/business-days-between?start=2026-03-01&end=2026-03-08&region=SA&weekend=4,5
{ "start": "2026-03-01", "end": "2026-03-08", "business_days": 5 }

Region changes the holiday set

July 3, 2026 is the observed US Independence Day holiday, but an ordinary working day in the UK:

 
GET /v1/is-business-day?date=2026-07-03&region=US
{ "date": "2026-07-03", "region": "US", "is_business_day": false }

GET /v1/is-business-day?date=2026-07-03&region=GB
{ "date": "2026-07-03", "region": "GB", "is_business_day": true }

Business-Day API FAQs

Each endpoint returns JSON data that indicates business day status, calculated dates, or the number of working days. For example, the "Is Business Day" endpoint returns whether a specific date is a working day, while the "Add Business Days" endpoint provides the resulting date after adding or subtracting business days.

Key fields in the response include "date" (the input date), "region" (the specified region), "is_business_day" (boolean for business day status), "result" (calculated date), and "business_days" (count of working days between two dates).

Los parámetros incluyen "fecha" (requerido) "región" (requerido) "subdiv" (opcional para subdivisiones) "fin de semana" (opcional para fines de semana personalizados) "días" (requerido para agregar/sustraer días) y "días_festivos_extra" (opcional para fechas de blackout personalizadas)

The response data is structured in a JSON format with key-value pairs. Each endpoint's response contains relevant fields based on the request, such as "start," "end," and "result" for date calculations, allowing users to easily parse and utilize the information.

The data is sourced from official holiday calendars for over 100 countries and their subdivisions. The API maintains current holiday information to ensure accuracy, allowing users to rely on it for precise business day calculations.

Los casos de uso típicos incluyen la logística y la estimación de fechas de entrega la programación de liquidaciones financieras el seguimiento de SLA el procesamiento de nómina y la programación de citas donde los cálculos precisos de días hábiles son cruciales para las operaciones

Users can customize requests by specifying parameters such as "subdiv" for regional subdivisions, "weekend" for non-standard weekends, and "extra_holidays" for custom closures, tailoring the calculations to their specific needs.

Users can utilize the returned data by interpreting the "is_business_day" field to determine scheduling feasibility, using "result" for planning future dates, and leveraging "business_days" for understanding timelines between events or deadlines.

General FAQs

Zyla API Hub es como una gran tienda de APIs, donde puedes encontrar miles de ellas en un solo lugar. También ofrecemos soporte dedicado y monitoreo en tiempo real de todas las APIs. Una vez que te registres, puedes elegir qué APIs quieres usar. Solo recuerda que cada API necesita su propia suscripción. Pero si te suscribes a varias, usarás la misma clave para todas, lo que hace todo más fácil para ti.
Los precios se muestran en USD (dólar estadounidense), EUR (euro), CAD (dólar canadiense), AUD (dólar australiano) y GBP (libra esterlina). Aceptamos todas las principales tarjetas de débito y crédito. Nuestro sistema de pago utiliza la última tecnología de seguridad y está respaldado por Stripe, una de las compañías de pago más confiables del mundo. Si tienes algún problema para pagar con tarjeta, contáctanos en [email protected]

Además, si ya tienes una suscripción activa en cualquiera de estas monedas (USD, EUR, CAD, AUD, GBP), esa moneda se mantendrá para suscripciones posteriores. Puedes cambiar la moneda en cualquier momento siempre que no tengas suscripciones activas.
La moneda local que aparece en la página de precios se basa en el país de tu dirección IP y se proporciona solo como referencia. Los precios reales están en USD (dólar estadounidense). Cuando realices un pago, el cargo aparecerá en tu estado de cuenta en USD, incluso si ves el monto equivalente en tu moneda local en nuestro sitio web. Esto significa que no puedes pagar directamente en tu moneda local.
Ocasionalmente, un banco puede rechazar el cargo debido a sus configuraciones de protección contra fraude. Te sugerimos comunicarte con tu banco primero para verificar si están bloqueando nuestros cargos. También puedes acceder al Portal de Facturación y cambiar la tarjeta asociada para realizar el pago. Si esto no funciona y necesitas más ayuda, por favor contacta a nuestro equipo en [email protected]
Los precios se determinan mediante una suscripción recurrente mensual o anual, dependiendo del plan elegido.
Las llamadas a la API se descuentan de tu plan en base a solicitudes exitosas. Cada plan incluye una cantidad específica de llamadas que puedes realizar por mes. Solo las llamadas exitosas, indicadas por una respuesta con estado 200, se contarán en tu total. Esto asegura que las solicitudes fallidas o incompletas no afecten tu cuota mensual.
Zyla API Hub funciona con un sistema de suscripción mensual recurrente. Tu ciclo de facturación comenzará el día en que compres uno de los planes de pago, y se renovará el mismo día del mes siguiente. Así que recuerda cancelar tu suscripción antes si quieres evitar futuros cargos.
Para actualizar tu plan de suscripción actual, simplemente ve a la página de precios de la API y selecciona el plan al que deseas actualizarte. La actualización será instantánea, permitiéndote disfrutar inmediatamente de las funciones del nuevo plan. Ten en cuenta que las llamadas restantes de tu plan anterior no se transferirán al nuevo plan, por lo que debes considerar esto al actualizar. Se te cobrará el monto total del nuevo plan.
Para verificar cuántas llamadas a la API te quedan en el mes actual, revisa el campo 'X-Zyla-API-Calls-Monthly-Remaining' en el encabezado de la respuesta. Por ejemplo, si tu plan permite 1,000 solicitudes por mes y has usado 100, este campo mostrará 900 llamadas restantes.
Para ver el número máximo de solicitudes a la API que permite tu plan, revisa el encabezado de la respuesta 'X-Zyla-RateLimit-Limit'. Por ejemplo, si tu plan incluye 1,000 solicitudes por mes, este encabezado mostrará 1,000.
El encabezado 'X-Zyla-RateLimit-Reset' muestra el número de segundos hasta que tu límite se restablezca. Esto te indica cuándo tu conteo de solicitudes se reiniciará. Por ejemplo, si muestra 3,600, significa que faltan 3,600 segundos para que el límite se restablezca.
Sí, puedes cancelar tu plan en cualquier momento desde tu cuenta, seleccionando la opción de cancelación en la página de Facturación. Ten en cuenta que las actualizaciones, degradaciones y cancelaciones tienen efecto inmediato. Además, al cancelar ya no tendrás acceso al servicio, incluso si te quedaban llamadas en tu cuota.
Para darte la oportunidad de probar nuestras APIs sin compromiso, ofrecemos una prueba gratuita de 7 días que te permite realizar hasta 50 llamadas a la API sin costo. Esta prueba solo se puede usar una vez, por lo que recomendamos aplicarla a la API que más te interese. Aunque la mayoría de nuestras APIs ofrecen prueba gratuita, algunas pueden no hacerlo. La prueba finaliza después de 7 días o cuando realices 50 solicitudes, lo que ocurra primero. Si alcanzas el límite de 50 solicitudes durante la prueba, deberás "Iniciar tu Plan de Pago" para continuar haciendo solicitudes. Puedes encontrar el botón "Iniciar tu Plan de Pago" en tu perfil bajo Suscripción -> Elige la API a la que estás suscrito -> Pestaña de Precios. Alternativamente, si no cancelas tu suscripción antes del día 7, tu prueba gratuita finalizará y tu plan se cobrará automáticamente, otorgándote acceso a todas las llamadas a la API especificadas en tu plan. Ten esto en cuenta para evitar cargos no deseados.
Después de 7 días, se te cobrará el monto total del plan al que estabas suscrito durante la prueba. Por lo tanto, es importante cancelar antes de que finalice el periodo de prueba. No se aceptan solicitudes de reembolso por olvidar cancelar a tiempo.
Cuando te suscribes a una prueba gratuita de una API, puedes realizar hasta 50 llamadas. Si deseas realizar más llamadas después de este límite, la API te pedirá que "Inicies tu Plan de Pago". Puedes encontrar el botón "Iniciar tu Plan de Pago" en tu perfil bajo Suscripción -> Elige la API a la que estás suscrito -> Pestaña de Precios.
Las Órdenes de Pago se procesan entre el día 20 y el 30 de cada mes. Si envías tu solicitud antes del día 20, tu pago será procesado dentro de ese período.
Puedes contactarnos a través de nuestro canal de chat para recibir asistencia inmediata. Siempre estamos en línea de 8 a. m. a 5 p. m. (EST). Si nos contactas fuera de ese horario, te responderemos lo antes posible. Además, puedes escribirnos por correo electrónico a [email protected]

APIs Relacionadas


También te puede interesar