> ## 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.

# Obtenha os feriados nacionais

Obtenha uma lista dos feriados nacionais dos países onde você opera. Use este endpoint para antecipar possíveis atrasos no processamento de pagamentos e planejar suas transações de acordo.


## OpenAPI

````yaml openapi/pt-br/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: Obtenha os feriados nacionais
      operationId: get-holidays
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acesso Bearer para autenticação. Este token é obtido nos
            endpoints [Obter token de acesso](/pt-br/reference/get-token) ou
            [Renovar token de acesso](/pt-br/reference/refresh-token).
          required: true
          schema:
            type: string
        - name: CountryISOCode3
          in: query
          description: ' ISO 3166-1 alfa-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: >-
            Obtenha os feriados de um ano específico. Se nenhum ano for
            especificado neste campo, a resposta retornará os feriados do ano
            atual.
          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: >-
                        [País](/pt-br/reference/country-codes). ISO 3166-1
                        alfa-3.
                    date:
                      type: string
                      description: 'Data do dia não útil. Formato: `YYYY-MM-DDThh:mm:ss` .'
                      format: date-time
                      examples:
                        - '2023-04-06T00:00:00'
                    description:
                      type: string
                      description: Descrição do dia não útil.
                  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: Solicitação inválida.
          content:
            application/json:
              schema:
                type: object
                anyOf:
                  - type: object
                    properties:
                      Status:
                        type: integer
                        description: Código de erro.
                      Message:
                        type: string
                        description: Informações adicionais sobre o erro.
                      TraceId:
                        type: string
                        description: ID de rastreamento do erro.
                    required:
                      - Status
                      - Message
                      - TraceId
                  - type: object
                    properties:
                      errors:
                        type: object
                        description: Lista de erros.
                        properties:
                          Year:
                            type: array
                            description: Ano.
                            items:
                              type: string
                      type:
                        type: string
                        description: Tipo de erro.
                      title:
                        type: string
                        description: Informações adicionais sobre o erro.
                      status:
                        type: integer
                        description: Código de erro.
                      traceId:
                        type: string
                        description: ID de rastreamento do erro.
                    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: Não autorizado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: Informações adicionais sobre a resposta.
                  code:
                    type: string
                    description: Código de status.
                  messages:
                    type: array
                    description: Lista de mensagens.
                    items:
                      type: object
                      properties:
                        token_class:
                          type: string
                          description: Classe Token.
                        token_type:
                          type: string
                          description: Tipo de token.
                        message:
                          type: string
                          description: Mensagem com informações adicionais.
                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.