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

# Check an address

> Resolve whether a free text address is in a third country for CESOP purposes.

<Note>
  This helper supports your filtering decisions and is not part of the submission flow. A third territory is a country outside the EU, or an EU territory excluded from the EU VAT area (e.g. the Canary Islands).
</Note>


## OpenAPI

````yaml post /reports/cesop/v1/addresses:check
openapi: 3.1.0
info:
  title: CESOP REST API
  description: >
    <p>REST API for reporting CESOP(The Central Electronic System of Payment
    information). Create a submission, send payees

    and payments under its id, then submit it to the regulatory authority.</p>


    <p><strong>Filtering is the reporting company's responsibility.</strong>
    This API reports the data you send as-is, and it does not decide which
    payments are reportable. Apply the CESOP filtering rules before sending.</p>


    <p><strong>European Commission's official reporting guideline:</strong>

    <a href="docs/cesop-guidelines-v1.2.pdf">CESOP Guidelines for the reporting
    of payment data v1.2 (PDF)</a></p>


    <p><strong>CESOP filtering rules, PSP's implementation guide:</strong>

    <a href="docs/cesop-filtering-rules.html">open the guide</a>. This is a
    quick reference only, it may not cover every case. For accurate handling of
    specific cases, refer to the regulation and official CESOP
    documentation.</p>


    <p><strong>Regulation:</strong>

    <a href="https://eur-lex.europa.eu/eli/dir/2020/284/oj">Council Directive
    (EU) 2020/284</a>

    &middot;

    <a
    href="https://taxation-customs.ec.europa.eu/taxation-1/central-electronic-system-payment-information-cesop_en">CESOP
    — European Commission</a></p>
  version: 0.0.1
servers:
  - url: https://api.rrc.dev.finventi.com
    description: Development
  - url: https://api.rrc.finventi.com
    description: Production
security:
  - bearer-jwt: []
tags:
  - name: CESOP Filtering Support
    description: >-
      Helper endpoints supporting CESOP filtering decisions. This is not part of
      the submission flow.Use them to prepare your data before sending it via
      the CESOP Submission API.
  - name: CESOP REST API
    description: >-
      REST API for submitting and correcting CESOP payee and payment data.
      Create a submission, push payees and payments under its id, then submit it
      to the regulatory authority.
paths:
  /reports/cesop/v1/addresses:check:
    post:
      tags:
        - CESOP Filtering Support
      summary: Check whether an address is in a third country
      description: |-
        Parses the free-text address and returns whether it resolves to a third
                    territory for CESOP purposes: a country outside the EU, or an EU territory excluded from the EU VAT
                    area (e.g. the Canary Islands).
      operationId: checkAddress
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddressCheckRequest'
        required: true
      responses:
        '200':
          description: Address resolved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddressCheckResponse'
        '422':
          description: No country could be resolved from the address
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddressCheckResponse'
        '503':
          description: Address resolution service is temporarily unavailable; retry later
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddressCheckResponse'
components:
  schemas:
    AddressCheckRequest:
      type: object
      description: Free-text address to resolve
      properties:
        address:
          type: string
          description: The address as one free-text line, in any format
          example: Calle Triana 25, 35002 Las Palmas de Gran Canaria, Spain
          maxLength: 1000
          minLength: 0
      required:
        - address
    AddressCheckResponse:
      type: object
      description: Result of resolving the address
      properties:
        thirdTerritory:
          type: boolean
          description: >-
            True when the address resolves to a third country for CESOP
            purposes: a country outside the EU, or an EU territory excluded from
            the EU VAT area (e.g. the Canary Islands).
        countryCode:
          type: string
          description: ISO 3166-1 alpha-2 code of the country the address resolved to
          example: ES
      required:
        - countryCode
        - thirdTerritory
  securitySchemes:
    bearer-jwt:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: >-
            https://auth.sandbox.finventi.com/realms/sti-connector/protocol/openid-connect/token
          scopes: {}

````