Stay22

Stay22 API

Stay22 API as documented publicly: 3 operations. Contract generated from the documentation by API Evangelist (2026-10-28); not the provider's own document.

Documentation GitHub OpenAPI

Operations 3

GET /v1/reporting/transactions GET /v1/reporting/transactions #

GET /v2/accommodations GET /v2/accommodations #

GET /v3/accommodations GET /v3/accommodations #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/stay22/openapi/_ae-authored/stay22-openapi-generated.yml

Schemas & Data

📊

JSONSchema

https://artifacts.apis.io/stay22/json-schema/stay22-get-v1-reporting-transactions-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/stay22/json-schema/stay22-get-v2-accommodations-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/stay22/json-schema/stay22-get-v3-accommodations-response-schema.json

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/stay22:stay22-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.1.0
info:
  title: Stay22 API
  version: '2026-10-27'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-27: 3 operation(s) read from 7 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Stay22 has published no machine-readable contract that the pipeline
    could find. Engine: anthropic.'
  x-evidence-tiers:
    code-example: 3
    documentation: 0
    pages-with-code: 7
    pages-read: 7
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-27'
  x-generator: generate-contract-from-docs.py
  x-engine: anthropic
  x-sources:
  - https://dev.stay22.com/docs/api/quickstart
  - https://dev.stay22.com/docs/api/authentication
  - https://dev.stay22.com/docs/api/accommodations/search
  - https://dev.stay22.com/docs/api/reporting/transactions
  - https://dev.stay22.com/docs/api/accommodations-v3/search
  - https://dev.stay22.com/docs/reporting/transactions
  - https://dev.stay22.com/docs/api/recipes/code-examples
servers:
- url: https://api.stay22.com
paths:
  /v1/reporting/transactions:
    get:
      operationId: get_v1_reporting_transactions
      tags:
      - Reporting
      summary: GET /v1/reporting/transactions
      x-source: https://dev.stay22.com/docs/api/reporting/transactions
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1ReportingTransactionsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl JavaScript Go Python Java C# curl -X GET "https://example.com/v1/reporting/transactions" 200 401 422 502 503 504 { "statusCode":
          0, "partnerId": "string", "data": [ { "provider": "string", "bookingId": "string", "bookedDate": "string", "startDate": "string", "endDate":
          "string", "bookingStatus": "string", "campaignId": "string", "campaignIds": [], "commission": "string", "currency": "string",'
  /v2/accommodations:
    get:
      operationId: get_v2_accommodations
      tags:
      - Accommodations
      summary: GET /v2/accommodations
      x-source: https://dev.stay22.com/docs/api/accommodations/search
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV2AccommodationsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl JavaScript Go Python Java C# curl -X GET "https://example.com/v2/accommodations" 200 400 401 429 502 504 { "meta": { "pageSize":
          10, "count": 2, "page": 1, "hasMore": true, "total": 20, "currency": "USD", "checkin": "2027-06-01", "checkout": "2027-06-04", "nights":
          3 }, "_links": { "self": { "href": "https://api.stay22.com/v2/accommodations?address=New+York&checkin=2027-06-01&checkout=2027-06'
  /v3/accommodations:
    get:
      operationId: get_v3_accommodations
      tags:
      - Accommodations
      summary: GET /v3/accommodations
      x-source: https://dev.stay22.com/docs/api/quickstart
      parameters:
      - name: address
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV3AccommodationsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -H \"X-API-KEY: <API_KEY>\"  \"https://api.stay22.com/v3/accommodations?address=Paris\" Read the response Each stay arrives\
          \ in results[] . Every stay carries a top-level url (a Stay22 deeplink that already carries your aid ) and a suppliers map keyed by\
          \ supplier. Without dates the search is static — no prices yet. { \n \"meta\" : { \"page\" : 1 , \"pageSize\" : 10 , \"total\" : 29758\
          \ , \"hasMore\" : true , "
components:
  schemas:
    GetV1ReportingTransactionsResponse:
      type: object
      properties:
        statusCode:
          type: integer
        partnerId:
          type: string
        data:
          type: array
          items:
            type: object
            properties:
              provider:
                type: string
              bookingId:
                type: string
              bookedDate:
                type: string
              startDate:
                type: string
              endDate:
                type: string
              bookingStatus:
                type: string
              campaignId:
                type: string
              campaignIds:
                type: array
                items: {}
              commission:
                type: string
              currency:
                type: string
              category:
                type: string
              quantity:
                type: integer
              information:
                type: string
              destination:
                type: string
              userCountry:
                type: string
              device:
                type: string
              lastUpdatedDate:
                type: string
              property1:
                type:
                - string
                - 'null'
              property2:
                type:
                - string
                - 'null'
        property1:
          type:
          - string
          - 'null'
        property2:
          type:
          - string
          - 'null'
    GetV2AccommodationsResponse:
      type: object
      properties:
        pageSize:
          type: integer
        count:
          type: integer
        page:
          type: integer
        hasMore:
          type: boolean
        total:
          type: integer
        currency:
          type: string
        checkin:
          type: string
          format: date
        checkout:
          type: string
          format: date
        nights:
          type: integer
    GetV3AccommodationsResponse:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        type:
          type: string
        url:
          type: string
        suppliers:
          type: object
          properties:
            booking:
              type: object
              properties:
                link:
                  type: string
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-KEY
security:
- apiKey: []
tags:
- name: Accommodations
- name: Reporting