Matchai Docs

List your sitesComing soon

Returns the Matchai Sites you can manage: your own and your teams’. A professional has one site of their own.

Coming soon. This is documented ahead of launch so you can plan your integration; it is not available yet.
GET
/sites

Coming soon. Returns the Matchai Sites you can manage: your own and your teams’. A professional has one site of their own.

Scopes: sites:read

Pricing: Included with the connection.

Authorization

headerAuthorizationBearer <matchai_<base62>>

A personal API key, sent as Authorization: Bearer matchai_…. Create keys in Matchai under Settings → Connectors → Advanced (for developers). A key starts with matchai_ followed by letters and digits, carries the scopes chosen when it was created, and can be revoked at any time. Keys reach only the account that created them: to serve other professionals, use Connect with Matchai.

Scope: sites:read

Query Parameters

limit?integer

How many results per page.

Range1 <= value <= 100
Default25
cursor?string

The next_cursor of the previous page. Cursors expire after 24 hours.

Lengthlength <= 512

Response Body

One page of sites.

application/json
  1. response

One page of results. Pass next_cursor as cursor to get the next page; it is null on the last page.

data*array<>
next_cursor*|

Cursor for the next page, or null when there are no more results.

Example Request
curl -X GET 'https://api.matchai.co/v1/sites'
Example Response
{  "data": [    {      "id": "string",      "subdomain": "string",      "url": "http://example.com",      "custom_domain": {        "hostname": "string",        "status": "pending"      },      "name": "string",      "tagline": "string",      "description": "string",      "hero_image_url": "http://example.com",      "contact_email": "user@example.com",      "contact_phone": "string",      "social_links": {        "website": "http://example.com",        "linkedin": "http://example.com",        "instagram": "http://example.com",        "facebook": "http://example.com",        "x": "http://example.com",        "youtube": "http://example.com",        "tiktok": "http://example.com"      },      "published": true,      "owner": {        "type": "user",        "id": "string",        "name": "string"      },      "listing_count": 0,      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z"    }  ],  "next_cursor": "string"}