> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取国家假日

获取您运营所在国家/地区的法定节假日列表。使用此接口可以预估支付处理延迟，并据此安排交易。


## OpenAPI

````yaml openapi/zh/localpayment.json GET /api/resources/holidays
openapi: 3.1.0
info:
  version: '1.0'
  title: Localpayment
  contact:
    name: Support
    url: mailto:support@localpayment.com
servers:
  - url: https://api.stage.localpayment.com
    description: Stage
security:
  - token: []
paths:
  /api/resources/holidays:
    get:
      summary: 获取国家假日
      operationId: get-holidays
      parameters:
        - name: Authorization
          in: header
          description: >-
            用于身份验证的 Bearer
            访问令牌。该令牌可从[获取访问令牌](/zh/reference/get-token)或[刷新访问令牌](/zh/reference/refresh-token)endpoint
            获取。
          required: true
          schema:
            type: string
        - name: CountryISOCode3
          in: query
          description: ' ISO 3166-1 alpha-3。'
          required: true
          schema:
            type: string
            enum:
              - ARG
              - BOL
              - BRA
              - CHL
              - COL
              - CRI
              - DOM
              - GTM
              - HND
              - MEX
              - PAN
              - PRY
              - PER
        - name: Year
          in: query
          description: 获取指定年份的节假日。如果此字段中未指定年份，则返回当前年份的节假日。
          schema:
            type: string
            minLength: 4
            maxLength: 4
            examples:
              - '2023'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    country:
                      type: string
                      description: '[国家](/zh/reference/country-codes)。ISO 3166-1 alpha-3。'
                    date:
                      type: string
                      description: 非工作日日期。格式：`YYYY-MM-DDThh:mm:ss` 。
                      format: date-time
                      examples:
                        - '2023-04-06T00:00:00'
                    description:
                      type: string
                      description: 非工作日描述。
                  required:
                    - country
                    - date
                    - description
                x-examples:
                  Example 1:
                    - country: MEX
                      date: '2023-01-01T00:00:00'
                      description: New Year Day
                    - country: MEX
                      date: '2023-02-06T00:00:00'
                      description: Mexican Constitution Day
                    - country: MEX
                      date: '2023-03-20T00:00:00'
                      description: Birthday of Benito Juárez
                    - country: MEX
                      date: '2023-04-06T00:00:00'
                      description: Easter Thursday
                    - country: MEX
                      date: '2023-04-07T00:00:00'
                      description: Easter Friday
                    - country: MEX
                      date: '2023-05-01T00:00:00'
                      description: Labour day
                    - country: MEX
                      date: '2023-05-05T00:00:00'
                      description: Battle of Puebla
                    - country: MEX
                      date: '2023-09-16T00:00:00'
                      description: Mexican Independence Day
                    - country: MEX
                      date: '2023-10-12T00:00:00'
                      description: Race Day
                    - country: MEX
                      date: '2023-11-02T00:00:00'
                      description: Deads Day
                    - country: MEX
                      date: '2023-11-20T00:00:00'
                      description: Mexican Revolution Day
                    - country: MEX
                      date: '2023-12-12T00:00:00'
                      description: Virgen de Guadalupe Day
                    - country: MEX
                      date: '2023-12-25T00:00:00'
                      description: Christmas
              examples:
                2023 MEX Holidays:
                  value:
                    - country: MEX
                      date: '2023-01-01T00:00:00'
                      description: New Year Day
                    - country: MEX
                      date: '2023-02-06T00:00:00'
                      description: Mexican Constitution Day
                    - country: MEX
                      date: '2023-03-20T00:00:00'
                      description: Birthday of Benito Juárez
                    - country: MEX
                      date: '2023-04-06T00:00:00'
                      description: Easter Thursday
                    - country: MEX
                      date: '2023-04-07T00:00:00'
                      description: Easter Friday
                    - country: MEX
                      date: '2023-05-01T00:00:00'
                      description: Labour day
                    - country: MEX
                      date: '2023-05-05T00:00:00'
                      description: Battle of Puebla
                    - country: MEX
                      date: '2023-09-16T00:00:00'
                      description: Mexican Independence Day
                    - country: MEX
                      date: '2023-10-12T00:00:00'
                      description: Race Day
                    - country: MEX
                      date: '2023-11-02T00:00:00'
                      description: Deads Day
                    - country: MEX
                      date: '2023-11-20T00:00:00'
                      description: Mexican Revolution Day
                    - country: MEX
                      date: '2023-12-12T00:00:00'
                      description: Virgen de Guadalupe Day
                    - country: MEX
                      date: '2023-12-25T00:00:00'
                      description: Christmas
                2023 ARG Holidays:
                  value:
                    - country: ARG
                      date: '2023-01-01T00:00:00'
                      description: New Year Day
                    - country: ARG
                      date: '2023-02-20T00:00:00'
                      description: Carnival
                    - country: ARG
                      date: '2023-02-21T00:00:00'
                      description: Carnival
                    - country: ARG
                      date: '2023-03-24T00:00:00'
                      description: National Day of Remembrance for Truth and Justice
                    - country: ARG
                      date: '2023-04-02T00:00:00'
                      description: Malvinas War Veteran's Day and Day of the Fallen
                    - country: ARG
                      date: '2023-04-06T00:00:00'
                      description: Easter Thursday
                    - country: ARG
                      date: '2023-04-07T00:00:00'
                      description: Easter Thursday
                    - country: ARG
                      date: '2023-05-01T00:00:00'
                      description: Labour Day
                    - country: ARG
                      date: '2023-05-25T00:00:00'
                      description: May Revolution Day
                    - country: ARG
                      date: '2023-05-26T00:00:00'
                      description: Tourist holiday
                    - country: ARG
                      date: '2023-06-17T00:00:00'
                      description: >-
                        Passage to Immortality of General Don Martín Miguel de
                        Güemes
                    - country: ARG
                      date: '2023-06-19T00:00:00'
                      description: Tourist holiday
                    - country: ARG
                      date: '2023-06-20T00:00:00'
                      description: The Immortality of General Manuel Belgrano
                    - country: ARG
                      date: '2023-07-09T00:00:00'
                      description: Independence Day
                    - country: ARG
                      date: '2023-08-17T00:00:00'
                      description: Immortality of General José de San Martín
                    - country: ARG
                      date: '2023-10-13T00:00:00'
                      description: Respect for Cultural Diversity Day
                    - country: ARG
                      date: '2023-11-20T00:00:00'
                      description: National Sovereignty Day
                    - country: ARG
                      date: '2023-12-08T00:00:00'
                      description: Immaculate Conception of Mary Day
                    - country: ARG
                      date: '2023-12-25T00:00:00'
                      description: Christmas
        '400':
          description: 错误的请求。
          content:
            application/json:
              schema:
                type: object
                anyOf:
                  - type: object
                    properties:
                      Status:
                        type: integer
                        description: 错误代码。
                      Message:
                        type: string
                        description: 其他错误信息。
                      TraceId:
                        type: string
                        description: 错误跟踪 ID。
                    required:
                      - Status
                      - Message
                      - TraceId
                  - type: object
                    properties:
                      errors:
                        type: object
                        description: 错误列表。
                        properties:
                          Year:
                            type: array
                            description: 年。
                            items:
                              type: string
                      type:
                        type: string
                        description: 错误类型。
                      title:
                        type: string
                        description: 其他错误信息。
                      status:
                        type: integer
                        description: 错误代码。
                      traceId:
                        type: string
                        description: 错误跟踪 ID。
                    required:
                      - errors
                      - type
                      - title
                      - status
                      - traceId
                x-examples:
                  Example 1:
                    Status: 400
                    Message: Country ISO code does not exist
                    TraceId: c02337bb-4250-4fd6-bc78-08376698186e
              examples:
                400 - Country ISO code does not exist.:
                  value:
                    Status: 400
                    Message: Country ISO code does not exist
                    TraceId: c02331bb-4550-3fd6-bc78-08376698526e
                400 - One or more validation errors occurred.:
                  value:
                    errors:
                      Year:
                        - The value 'a' is not valid for Year.
                    type: https://tools.ietf.org/html/rfc9110#section-15.5.1
                    title: One or more validation errors occurred.
                    status: 400
                    traceId: 00-be1c02558ff6ffcd55ef8fa677592522-f4487f6014ab03d9-00
        '401':
          description: 未经授权。
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: 回复的补充信息。
                  code:
                    type: string
                    description: 状态码。
                  messages:
                    type: array
                    description: 消息列表。
                    items:
                      type: object
                      properties:
                        token_class:
                          type: string
                          description: Token 类。
                        token_type:
                          type: string
                          description: 令牌类型。
                        message:
                          type: string
                          description: 包含补充信息的消息。
                x-examples:
                  Example 1:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
              examples:
                401 - Token is invalid or expired:
                  value:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
      security:
        - token: []
      servers:
        - url: https://api.stage.localpayment.com
          description: Stage
components:
  securitySchemes:
    token:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.