ParseAPI Date API

An ISO date, validity, and Unix timestamp.

GitHub OpenAPI

Operations 2

GET /date/{date} Parse a date #
GET /date Today (UTC) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/parseapi-com:parseapi-com-date-api"
All apis
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.

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

parseapi-com-date-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Parse Date API
  version: 1.0.0
  summary: Fast APIs for developers, locate, validate, decode.
  description: 'One base URL, one key, minimal JSON. Response schemas describe API 2.3.0. Paid plans include their profile detail automatically at its natural resource homes; Free returns the complete ordinary answer. There is no deep response object. When neither version header is sent, requests use the saved team default, or 1.0.0 for keyless self-lookups. Read https://parseapi.com/docs/versioning for other supported contracts. Responses that reach the organization rate check carry X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. Optional X-RateLimit-Burst indicates continuous refill. Rate-limit 429 responses add Retry-After (seconds). See https://parseapi.com/agents and https://parseapi.com/llms.txt for agent-oriented guidance. Field-level docs: https://parseapi.com/docs Free-plan users must include a link to ParseAPI on their website, app, or project documentation. A footer, about page, credits page, or another reasonable location is fine. Paid plans do not require ParseAPI attribution. Example HTML: Data provided by ParseAPI. Details: https://parseapi.com/legal/attribution#crediting-parseapi.'
  termsOfService: https://parseapi.com/legal/terms
  contact:
    name: ParseAPI
    email: hello@parseapi.com
    url: https://parseapi.com
servers:
- url: https://api.parseapi.com
  description: Production
tags:
- name: Date
  description: An ISO date, validity, and Unix timestamp.
  externalDocs:
    description: Date API docs
    url: https://parseapi.com/docs/date
paths:
  /date/{date}:
    get:
      operationId: date
      tags:
      - Date
      summary: Parse a date
      description: 'Parses ISO, spelled months (March 29, 2026 / 29 Aug 2026), numeric (3/29/2026), and compact (20260829) into ISO date, validity and Unix time. Pooled deep adds calendar components, weekday, ISO week, quarter and leap-year detail. Ambiguous numeric dates answer valid false unless format= asserts a reading. Junk is a 200 with valid false, never a 404. Add to= for the signed days between two dates. Full field reference: https://parseapi.com/docs/date'
      security:
      - ApiKeyAuth: []
      - BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/ParseVersion'
      - name: date
        in: path
        required: true
        description: Supplied check value. Invalid values return HTTP 200 with valid false.
        schema:
          type: string
          example: March 29, 2026
          maxLength: 4096
      - name: format
        in: query
        required: false
        description: mdy or dmy. Breaks the tie on numeric dates where both readings are real days (03/04/2026). Applies to to= as well
        schema:
          type: string
          enum:
          - mdy
          - dmy
      - name: to
        in: query
        required: false
        description: Supplied check value. Invalid values return HTTP 200 with valid false.
        schema:
          type: string
          example: '2026-12-25'
          maxLength: 4096
      - name: lang
        in: query
        required: false
        description: Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.
        schema:
          type: string
          minLength: 2
          maxLength: 64
          example: fr
          x-supported-locales:
          - en
          - ar
          - ca
          - hr
          - cs
          - da
          - nl
          - fi
          - fr
          - de
          - el
          - he
          - hi
          - hu
          - id
          - it
          - ja
          - ko
          - ms
          - nb
          - pl
          - pt
          - ro
          - ru
          - zh-Hans
          - sk
          - es
          - sv
          - th
          - zh-Hant
          - tr
          - uk
          - vi
      - name: deep
        in: query
        required: false
        description: Calendar components, ISO week, quarter and leap-year detail. Included automatically on paid plans in API 2.2. Existing accounts retain their current profile access.
        schema:
          type: boolean
      responses:
        '200':
          description: Success, minimal JSON object (shape varies by endpoint)
          headers:
            X-RateLimit-Limit:
              description: Sustained requests per minute for your team
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Estimated requests available in the current window or token bucket
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
              schema:
                type: integer
            X-RateLimit-Burst:
              description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
              schema:
                type: integer
            X-API-Version:
              description: The exact response contract selected for this request.
              schema:
                type: string
                enum:
                - 1.0.0
                - 2.0.0
                - 2.1.0
                - 2.2.0
                - 2.3.0
            Content-Language:
              description: Languages used in selected display fields, including known English fallbacks. Unchanged native or source text does not imply a language.
              schema:
                type: string
                example: fr
          content:
            application/json:
              schema:
                type: object
                properties:
                  date:
                    type: string
                  valid:
                    type: boolean
                  unix:
                    type:
                    - integer
                    - 'null'
                  to:
                    type: string
                  days:
                    type:
                    - integer
                    - 'null'
                  year:
                    type:
                    - integer
                    - 'null'
                  month:
                    type:
                    - integer
                    - 'null'
                  month_name:
                    type:
                    - string
                    - 'null'
                  day:
                    type:
                    - integer
                    - 'null'
                  weekday:
                    type:
                    - integer
                    - 'null'
                  weekday_name:
                    type:
                    - string
                    - 'null'
                  week:
                    type:
                    - integer
                    - 'null'
                  week_year:
                    type:
                    - integer
                    - 'null'
                  day_of_year:
                    type:
                    - integer
                    - 'null'
                  quarter:
                    type:
                    - integer
                    - 'null'
                  leap:
                    type:
                    - boolean
                    - 'null'
                  days_in_month:
                    type:
                    - integer
                    - 'null'
                required:
                - date
                - valid
                - unix
                additionalProperties: true
        '400':
          description: invalid_request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: invalid_api_key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: permission_denied or plan_required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: not_found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '410':
          description: api_version_retired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: rate_limited or quota_exceeded
          headers:
            X-RateLimit-Limit:
              description: Sustained requests per minute for your team
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Estimated requests available in the current window or token bucket
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
              schema:
                type: integer
            X-RateLimit-Burst:
              description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
              schema:
                type: integer
            Retry-After:
              description: Seconds to wait before retrying
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: server_error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: service_unavailable
          headers:
            Retry-After:
              description: Seconds to wait before retrying
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /date:
    get:
      operationId: date_today
      tags:
      - Date
      summary: Today (UTC)
      description: 'Normalized date, validity and Unix time for today in UTC; calendar detail is optional pooled deep. Add to= for days from today: /date?to=2026-12-25 is days until Christmas. Full field reference: https://parseapi.com/docs/date'
      security:
      - ApiKeyAuth: []
      - BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/ParseVersion'
      - name: to
        in: query
        required: false
        description: Supplied check value. Invalid values return HTTP 200 with valid false.
        schema:
          type: string
          example: '2026-12-25'
          maxLength: 4096
      - name: lang
        in: query
        required: false
        description: Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.
        schema:
          type: string
          minLength: 2
          maxLength: 64
          example: fr
          x-supported-locales:
          - en
          - ar
          - ca
          - hr
          - cs
          - da
          - nl
          - fi
          - fr
          - de
          - el
          - he
          - hi
          - hu
          - id
          - it
          - ja
          - ko
          - ms
          - nb
          - pl
          - pt
          - ro
          - ru
          - zh-Hans
          - sk
          - es
          - sv
          - th
          - zh-Hant
          - tr
          - uk
          - vi
      - name: deep
        in: query
        required: false
        description: Calendar components, ISO week, quarter and leap-year detail. Included automatically on paid plans in API 2.2. Existing accounts retain their current profile access.
        schema:
          type: boolean
      responses:
        '200':
          description: Success, minimal JSON object (shape varies by endpoint)
          headers:
            X-RateLimit-Limit:
              description: Sustained requests per minute for your team
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Estimated requests available in the current window or token bucket
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
              schema:
                type: integer
            X-RateLimit-Burst:
              description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
              schema:
                type: integer
            X-API-Version:
              description: The exact response contract selected for this request.
              schema:
                type: string
                enum:
                - 1.0.0
                - 2.0.0
                - 2.1.0
                - 2.2.0
                - 2.3.0
            Content-Language:
              description: Languages used in selected display fields, including known English fallbacks. Unchanged native or source text does not imply a language.
              schema:
                type: string
                example: fr
          content:
            application/json:
              schema:
                type: object
                properties:
                  date:
                    type: string
                  valid:
                    type: boolean
                  unix:
                    type:
                    - integer
                    - 'null'
                  to:
                    type: string
                  days:
                    type:
                    - integer
                    - 'null'
                  year:
                    type:
                    - integer
                    - 'null'
                  month:
                    type:
                    - integer
                    - 'null'
                  month_name:
                    type:
                    - string
                    - 'null'
                  day:
                    type:
                    - integer
                    - 'null'
                  weekday:
                    type:
                    - integer
                    - 'null'
                  weekday_name:
                    type:
                    - string
                    - 'null'
                  week:
                    type:
                    - integer
                    - 'null'
                  week_year:
                    type:
                    - integer
                    - 'null'
                  day_of_year:
                    type:
                    - integer
                    - 'null'
                  quarter:
                    type:
                    - integer
                    - 'null'
                  leap:
                    type:
                    - boolean
                    - 'null'
                  days_in_month:
                    type:
                    - integer
                    - 'null'
                required:
                - date
                - valid
                - unix
                additionalProperties: true
        '400':
          description: invalid_request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: invalid_api_key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: permission_denied or plan_required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: not_found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '410':
          description: api_version_retired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: rate_limited or quota_exceeded
          headers:
            X-RateLimit-Limit:
              description: Sustained requests per minute for your team
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Estimated requests available in the current window or token bucket
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
              schema:
                type: integer
            X-RateLimit-Burst:
              description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
              schema:
                type: integer
            Retry-After:
              description: Seconds to wait before retrying
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: server_error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: service_unavailable
          headers:
            Retry-After:
              description: Seconds to wait before retrying
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  parameters:
    ParseVersion:
      name: X-API-Version
      in: header
      required: false
      description: Exact response contract for this lookup. Overrides the saved team default for this request only. Legacy Parse-Version is also accepted; both headers must match if sent together. With neither header, keyed requests use that default and keyless self-lookups use 1.0.0. Invalid or unsupported values return invalid_request (400). Retired selections return api_version_retired (410). Reference/help URLs keep their documented version and do not use this selector.
      schema:
        type: string
        enum:
        - 1.0.0
        - 2.0.0
        - 2.1.0
        - 2.2.0
        - 2.3.0
        example: 2.3.0
  schemas:
    Error:
      type: object
      required:
      - code
      - message
      - docs
      - request_id
      properties:
        code:
          type: string
          description: Machine-readable error code
          enum:
          - invalid_request
          - ambiguous_time
          - nonexistent_time
          - invalid_api_key
          - permission_denied
          - plan_required
          - not_found
          - api_version_retired
          - rate_limited
          - quota_exceeded
          - server_error
          - service_unavailable
          - dns_resolution_failed
          - task_invalid
          - task_not_found
          - task_request_conflict
          - task_budget_exceeded
          - task_limit_exceeded
          - task_terms_changed
          - task_expired
          - task_cancelled
          - task_in_progress
          - task_outcome_unknown
          - task_unavailable
        message:
          type: string
        docs:
          type: string
          format: uri
          description: Link to the docs section for this error
        request_id:
          type: string
          description: Send this if you contact support
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key from the ParseAPI dashboard
    BearerAuth:
      type: http
      scheme: bearer
      description: 'Same key as X-API-Key, via Authorization: Bearer'