Dateio API

openapi: 3.1.0
info:
  title: Dateio API
  version: '2026-10-21'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-21: 10 operation(s) read from 4 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Dateio has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 0
    documentation: 10
    pages-with-code: 1
    pages-read: 4
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-21'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://developers.tapix.io/tapix-original-doc/tapix_api_v6.yaml
  - https://developers.tapix.io/guides/atm-nearby
  - https://developers.tapix.io/guides/enrich-card-payment-data
  - https://developers.tapix.io/guides/recurring-payment-intelligence
paths:
  /atms/complete/findNearby:
    get:
      operationId: get_atms_complete_findNearby
      tags:
      - Atms
      summary: The GET /atms/complete/findNearby endpoint returns a list of ATM machines located near a specified point.
      description: Returns nearby ATMs with optional filtering. Results are sorted by distance and include detailed ATM, merchant, location, fee
        and status information.
      x-source: https://developers.tapix.io/guides/atm-nearby
      parameters:
      - name: lat
        in: query
        required: true
        schema:
          type: string
        description: Latitude of the centre point.
      - name: long
        in: query
        required: true
        schema:
          type: string
        description: Longitude of the centre point.
      - name: radius
        in: query
        required: true
        schema:
          type: string
        description: Search radius in meters.
      - name: countLimit
        in: query
        required: false
        schema:
          type: string
        description: Maximum number of results to return (default 50, maximum 200).
      - name: contactless
        in: query
        required: false
        schema:
          type: string
        description: Boolean filter – true to include only ATMs supporting contactless withdrawals.
      - name: depositAtm
        in: query
        required: false
        schema:
          type: string
        description: Boolean filter – true to include only ATMs that support cash deposits.
      - name: voiceAssistant
        in: query
        required: false
        schema:
          type: string
        description: Boolean filter – true to include only ATMs with voice assistance.
      - name: wheelchairAccess
        in: query
        required: false
        schema:
          type: string
        description: Boolean filter – true to include only ATMs with wheelchair access.
      - name: openNonStop
        in: query
        required: false
        schema:
          type: string
        description: Boolean filter – true to include only ATMs that are open 24/7.
      - name: openNow
        in: query
        required: false
        schema:
          type: string
        description: Boolean filter – true to include only ATMs that are currently open.
      - name: isFree
        in: query
        required: false
        schema:
          type: string
        description: Boolean filter – true to include only fee‑free ATMs.
      - name: allianceOnly
        in: query
        required: false
        schema:
          type: string
        description: Boolean filter – true to include only ATMs belonging to an alliance network.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAtmsCompleteFindnearbyResponse'
      x-evidence:
        kind: documentation
  /feedback:
    post:
      operationId: post_feedback
      tags:
      - Feedback
      summary: Feedback API Helps us to better understand the subscriptions.
      x-source: https://developers.tapix.io/guides/recurring-payment-intelligence
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /invalidations:
    get:
      operationId: get_invalidations
      tags:
      - Invalidations
      summary: Get paginated list of all invalidated items within the given numeric ID range
      x-source: https://developers.tapix.io/tapix-original-doc/tapix_api_v6.yaml
      parameters:
      - name: fromId
        in: query
        required: false
        schema:
          type: integer
        description: The numeric ID of the first item to be returned. If omitted, the list starts from the earliest available ID.
      - name: level
        in: query
        required: false
        schema:
          type: array
        description: The result will only contain invalidated items with specified levels. If the value is empty or missing, no filter will be
          applied.
      - name: pageSize
        in: query
        required: true
        schema:
          type: integer
        description: Specifies a limited number of items in the result set to be returned based on this value.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetInvalidationsResponse'
      x-evidence:
        kind: documentation
  /invalidations/item/range:
    get:
      operationId: get_invalidations_item_range
      tags:
      - Invalidations
      summary: Get a numeric ID range of the all items invalidated between given timestamps
      x-source: https://developers.tapix.io/tapix-original-doc/tapix_api_v6.yaml
      parameters:
      - name: from
        in: query
        required: true
        schema:
          type: string
        description: Only items invalidated after this timestamp will get to the result range.
      - name: to
        in: query
        required: false
        schema:
          type: string
        description: Only items invalidated before this timestamp will get to the result range.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetInvalidationsItemRangeResponse'
      x-evidence:
        kind: documentation
  /shops/complete/findByCardTransaction:
    get:
      operationId: get_shops_complete_findByCardTransaction
      tags:
      - Shops
      summary: Enrich card payment data
      x-source: https://developers.tapix.io/guides/enrich-card-payment-data
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /shops/complete/findByCardTransactionBatch:
    post:
      operationId: post_shops_complete_findByCardTransactionBatch
      tags:
      - Shops
      summary: Enrich card payment data
      x-source: https://developers.tapix.io/guides/enrich-card-payment-data
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /shops/findByCardTransaction:
    get:
      operationId: get_shops_findByCardTransaction
      tags:
      - Shops
      summary: Enrich card payment data
      x-source: https://developers.tapix.io/guides/enrich-card-payment-data
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /shops/findByCardTransactionBatch:
    post:
      operationId: post_shops_findByCardTransactionBatch
      tags:
      - Shops
      summary: Enrich card payment data
      x-source: https://developers.tapix.io/guides/enrich-card-payment-data
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v6/feedback:
    post:
      operationId: post_v6_feedback
      tags:
      - Feedback
      summary: Report improvements or corrections.
      x-source: https://developers.tapix.io/tapix-original-doc/tapix_api_v6.yaml
      parameters:
      - name: body
        in: header
        required: false
        schema:
          type: object
        description: JSON body containing the feedback payload.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV6FeedbackRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV6FeedbackResponse'
      x-evidence:
        kind: documentation
  /v6/suggestions:
    post:
      operationId: post_v6_suggestions
      tags:
      - Suggestions
      summary: Report improvements or corrections.
      description: Deprecated. This endpoint has been replaced by POST /v6/feedback.
      x-source: https://developers.tapix.io/tapix-original-doc/tapix_api_v6.yaml
      parameters:
      - name: body
        in: header
        required: false
        schema:
          type: object
        description: JSON body containing the suggestion payload.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV6SuggestionsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV6SuggestionsResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetAtmsCompleteFindnearbyResponse:
      type: object
      properties:
        results:
          type: array
          description: Array of ATM result objects.
        results[].atm:
          type: object
          description: Details about the ATM.
        results[].atm.uid:
          type: string
          description: Unique identifier of the ATM.
        results[].atm.contactless:
          type: boolean
          description: Whether the ATM supports contactless withdrawals.
        results[].atm.depositAtm:
          type: boolean
          description: Whether the ATM supports cash deposits.
        results[].atm.voiceAssistant:
          type: boolean
          description: Whether the ATM provides voice assistance.
        results[].atm.wheelchairAccess:
          type: boolean
          description: Whether the ATM is wheelchair accessible.
        results[].atm.openNonStop:
          type: boolean
          description: True if the ATM is open 24/7.
        results[].atm.openingHours:
          type: string
          description: Opening hours in OSM format.
        results[].atm.openStatus:
          type: object
          description: Current open status.
        results[].atm.openStatus.isOpen:
          type: boolean
          description: True if the ATM is currently open.
        results[].atm.openStatus.minutesToClose:
          type: integer
          description: Minutes until the ATM closes (present when isOpen is true).
        results[].atm.openStatus.minutesToOpen:
          type: integer
          description: Minutes until the ATM opens (present when isOpen is false).
        results[].atm.merchant:
          type: object
          description: Operator information.
        results[].atm.merchant.uid:
          type: string
          description: Merchant unique identifier.
        results[].atm.merchant.name:
          type: string
          description: Merchant name.
        results[].atm.merchant.logo:
          type: string
          description: URL to merchant logo.
        results[].atm.location:
          type: object
          description: Location details.
        results[].atm.location.address:
          type: object
          description: Postal address.
        results[].atm.location.address.street:
          type: string
          description: Street name.
        results[].atm.location.address.city:
          type: string
          description: City.
        results[].atm.location.address.zip:
          type: string
          description: ZIP/postal code.
        results[].atm.location.address.country:
          type: string
          description: Country code.
        results[].atm.location.coordinates:
          type: object
          description: GPS coordinates.
        results[].atm.location.coordinates.lat:
          type: number
          description: Latitude.
        results[].atm.location.coordinates.long:
          type: number
          description: Longitude.
        results[].atm.fee:
          type: object
          description: Operator surcharge.
        results[].atm.fee.currency:
          type: string
          description: Currency code (when fee is a fixed amount).
        results[].atm.fee.amount:
          type: number
          description: Fixed fee amount.
        results[].atm.fee.percentage:
          type: number
          description: Fee expressed as a percentage.
        results[].distance:
          type: integer
          description: Distance in meters from the query point.
        count:
          type: integer
          description: Number of ATMs returned in this response.
        countLimit:
          type: integer
          description: Maximum number of results requested.
        totalCount:
          type: integer
          description: Total number of ATMs matching the query before applying the limit.
        timestamp:
          type: integer
          description: Unix timestamp of error response (when status != 200).
        status:
          type: integer
          description: HTTP status code of error response.
        reason:
          type: string
          description: Reason phrase of error response.
        message:
          type: string
          description: Error message describing the problem.
    GetInvalidationsResponse:
      type: object
      properties:
        '200':
          type: string
          description: Result contains one page of a list of invalidation batches and information about next page
        '400':
          type: string
          description: Invalid input
    GetInvalidationsItemRangeResponse:
      type: object
      properties:
        '200':
          type: string
          description: Result contains a numeric ID range of all invalidated items between given timestamps
        '400':
          type: string
          description: Invalid date format
    PostV6FeedbackRequest:
      type: object
      properties:
        body:
          type: object
          description: Feedback object as defined in the specification.
      required:
      - body
    PostV6FeedbackResponse:
      type: object
      properties:
        '200':
          type: string
          description: Feedback was accepted
        '400':
          type: string
          description: Invalid input (missing/empty `suggestion` map or `source`, or unparseable `requestTimestamp`/`source`)
    PostV6SuggestionsRequest:
      type: object
      properties:
        body:
          type: object
          description: Suggestion object as defined in the specification.
      required:
      - body
    PostV6SuggestionsResponse:
      type: object
      properties:
        '200':
          type: string
          description: Suggestion was accepted
        '400':
          type: string
          description: Invalid input
tags:
- name: Atms
- name: Feedback
- name: Invalidations
- name: Shops
- name: Suggestions