The Aryeo API provides access to the Aryeo platform.

Languages
Servers
Mock server

https://docs.aryeo.com/_mock/api/aryeo/

Production

https://api.aryeo.com/v1/

Addresses

Operations related to addresses.

Operations

Appointments

Operations related to appointments.

Operations

Discounts

Operations related to discounts.

Operations

Listings

Operations related to listings.

Operations

Notes

Operations related to notes.

Operations

Order Forms

Operations related to order forms.

Operations

Order Items

Operations related to order items.

Operations

Orders

Operations related to orders.

Operations

Payroll

Operations related to payroll.

Operations

Products

Operations related to products.

Operations

Scheduling

Operations related to scheduling.

Operations

Create block.

Request

Create block.

undocumented: true
external: true
const resp = await fetch(
  `https://docs.aryeo.com/_mock/api/aryeo/blocks`,
  {
    method: 'POST',
    headers: {
      Authorization: 'Bearer <YOUR_TOKEN_HERE>'
    }
  }
);

const data = await resp.text();
console.log(data);

Responses

201

Bodyapplication/json
object
Response
application/json
{}

Delete block.

Request

Delete block.

undocumented: true
external: true
Path
block_idstring(uuid)= 36 characters^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0...required

The ID of a block. UUID Version 4.

Example: 00000000-0000-4000-8000-000000000000
const blockId = '00000000-0000-4000-8000-000000000000';
const resp = await fetch(
  `https://docs.aryeo.com/_mock/api/aryeo/blocks/${blockId}`,
  {
    method: 'DELETE',
    headers: {
      Authorization: 'Bearer <YOUR_TOKEN_HERE>'
    }
  }
);

const data = await resp.text();
console.log(data);

Responses

200

Bodyapplication/json
object
Response
application/json
{}

Get block.

Request

Get block.

undocumented: true
external: true
Path
block_idstring(uuid)= 36 characters^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0...required

The ID of a block. UUID Version 4.

Example: 00000000-0000-4000-8000-000000000000
const blockId = '00000000-0000-4000-8000-000000000000';
const resp = await fetch(
  `https://docs.aryeo.com/_mock/api/aryeo/blocks/${blockId}`,
  {
    method: 'GET',
    headers: {
      Authorization: 'Bearer <YOUR_TOKEN_HERE>'
    }
  }
);

const data = await resp.text();
console.log(data);

Responses

200

Bodyapplication/json
object
Response
application/json
{}

Update block.

Request

Update block.

undocumented: true
external: true
Path
block_idstring(uuid)= 36 characters^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0...required

The ID of a block. UUID Version 4.

Example: 00000000-0000-4000-8000-000000000000
const blockId = '00000000-0000-4000-8000-000000000000';
const resp = await fetch(
  `https://docs.aryeo.com/_mock/api/aryeo/blocks/${blockId}`,
  {
    method: 'PUT',
    headers: {
      Authorization: 'Bearer <YOUR_TOKEN_HERE>'
    }
  }
);

const data = await resp.text();
console.log(data);

Responses

200

Bodyapplication/json
object
Response
application/json
{}

List regions.

Request

List regions.

undocumented: true
external: true
const resp = await fetch(
  `https://docs.aryeo.com/_mock/api/aryeo/regions`,
  {
    method: 'GET',
    headers: {
      Authorization: 'Bearer <YOUR_TOKEN_HERE>'
    }
  }
);

const data = await resp.text();
console.log(data);

Responses

200

Bodyapplication/json
object
Response
application/json
{}

Get scheduling assignment.

Request

Get scheduling assignment.

undocumented: true
external: true
const resp = await fetch(
  `https://docs.aryeo.com/_mock/api/aryeo/scheduling/assignment`,
  {
    method: 'GET',
    headers: {
      Authorization: 'Bearer <YOUR_TOKEN_HERE>'
    }
  }
);

const data = await resp.text();
console.log(data);

Responses

200

Bodyapplication/json
object
Response
application/json
{}

List available dates.

Request

List available dates. Availability can be listed using a specific start & end date range, or using a timeframe. When using a timeframe, the page parameter can be used to flip through weeks, months, etc.

external: true
Query
filter[user_ids][]Array of strings(uuid)

The IDs of users whose availability will be listed. UUID Version 4.

Example: filter[user_ids][]=00000000-0000-4000-8000-000000000000
filter[appointment_id]string= 36 characters^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0...

Appointment ID used to list availability for an existing order

Example: filter[appointment_id]=00000000-0000-4000-8000-000000000000
filter[start_at]string(date-time)= 20 characters

Returns availability after start_at

Example: filter[start_at]=2021-01-01T13:00:00Z
filter[end_at]string(date-time)= 20 characters

Returns availability before end_at

Example: filter[end_at]=2021-01-02T13:00:00Z
filter[timeframe]string[ 1 .. 5 ] characters

Returns availability for a specific timeframe. Used instead of start_at & end_at

Enum"DAY""WEEK""MONTH""YEAR"
Example: filter[timeframe]=MONTH
durationinteger[ 1 .. 360 ]

Duration of the event to schedule. Required if appointment_id isn't specified

Example: duration=60
intervalinteger[ 1 .. 360 ]

Interval of bookable timeslots starting at x minutes on the hour . Required if appointment_id isn't specified

Example: interval=15
timezonestring[ 3 .. 50 ] charactersrequired

The timezone of the client. Available dates results will be localized to this timezone

Example: timezone=CST
pageinteger>= 1

The requested page of results. Use this parameter to flip through pages when using the timeframe filter

Example: page=1
per_pageinteger

The number of results per page. Only applies when using a date range

Example: per_page=5
const query = new URLSearchParams({timezone: 'CST'}).toString();

const resp = await fetch(
  `https://docs.aryeo.com/_mock/api/aryeo/scheduling/available-dates?${query}`,
  {
    method: 'GET',
    headers: {
      Authorization: 'Bearer <YOUR_TOKEN_HERE>'
    }
  }
);

const data = await resp.text();
console.log(data);

Responses

CalendarDayCollection

Bodyapplication/json
statusstring[ 0 .. 255 ] charactersrequired

What was the state of the request?

Example: "success"
dataArray of objects or null(CalendarDay)

A collection of objects.

metaobject(CalendarDayCollectionMeta)

Metadata about a calendar day paginated response.

linksobject(PaginationLinks)

Related links for a paginated response.

timestampstring or null(date-time)= 20 characters

The request timestamp (ISO 8601).

Example: "2021-06-30T20:30:00Z"
Response
application/json
{ "status": "success", "data": [ { "date": "2021-01-01", "is_available": true } ], "meta": { "group_id": "00000000-0000-4000-8000-000000000000", "company_id": "00000000-0000-4000-8000-000000000000", "company_team_member_ids": [ "00000000-0000-4000-8000-000000000000" ], "user_ids": [ "00000000-0000-4000-8000-000000000000" ], "appointment_id": "00000000-0000-4000-8000-000000000000", "start_at": "2021-06-30T20:30:00Z", "end_at": "2021-06-30T21:30:00Z", "timezone": "CST", "is_twilight": true, "interval": 30, "duration": 30, "current_page": 1, "timeframe": "DAY", "timeframe_period": { "startDate": "2025-04-01T05:59:59.999999Z", "endDate": "2025-04-01T05:59:59.999999Z", "startDateIncluded": true, "endDateIncluded": true }, "from": 1, "last_page": 4, "links": [ { "url": "https://admin.aryeo.test/api/v1/companies?page=2", "label": "2", "active": true } ], "path": "https://api.aryeo.com/v1/{path}", "per_page": 15, "to": 15, "total": 50 }, "links": { "first": "https://api.aryeo.com/v1/{path}?page=1", "last": "https://api.aryeo.com/v1/{path}?page=10", "prev": "https://api.aryeo.com/v1/{path}?page=2", "next": "https://api.aryeo.com/v1/{path}?page=3" }, "timestamp": "2021-06-30T20:30:00Z" }

List available timeslots.

Request

List available timeslots. Timeslots are returned for the entire day in the local timezone.

Results are returned in UTC!

external: true
Query
filter[user_ids][]Array of strings(uuid)

The IDs of users whose appointments will be listed. UUID Version 4.

Example: filter[user_ids][]=00000000-0000-4000-8000-000000000000
filter[appointment_id]string= 36 characters^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0...

Appointment ID used to list availability for an existing order

Example: filter[appointment_id]=00000000-0000-4000-8000-000000000000
durationinteger[ 1 .. 360 ]

Duration of the event to schedule. Required if appointment_id isn't specified

Example: duration=60
intervalinteger[ 1 .. 360 ]

Interval of bookable timeslots starting at x minutes on the hour . Required if appointment_id isn't specified

Example: interval=25
pageinteger>= 1

The requested page of results

Example: page=1
per_pageinteger>= 1

The number of results per page. Only applies when using a date range

Example: per_page=5
datestring(date)= 10 charactersrequired

The date to list available timeslots

Example: date=2021-01-01
timezonestring[ 3 .. 50 ] charactersrequired

The timezone is used to determine the start and end time of the specified date to list a full day of results.

Example: timezone=CST
const query = new URLSearchParams({
  date: '2021-01-01',
  timezone: 'CST'
}).toString();

const resp = await fetch(
  `https://docs.aryeo.com/_mock/api/aryeo/scheduling/available-timeslots?${query}`,
  {
    method: 'GET',
    headers: {
      Authorization: 'Bearer <YOUR_TOKEN_HERE>'
    }
  }
);

const data = await resp.text();
console.log(data);

Responses

TimeslotCollection

Bodyapplication/json
statusstring[ 0 .. 255 ] charactersrequired

What was the state of the request?

Example: "success"
dataArray of objects or null(Timeslot)

A collection of objects.

metaobject(CalendarDayCollectionMeta)

Metadata about a calendar day paginated response.

linksobject(PaginationLinks)

Related links for a paginated response.

timestampstring or null(date-time)= 20 characters

The request timestamp (ISO 8601).

Example: "2021-06-30T20:30:00Z"
Response
application/json
{ "status": "success", "data": [ { "start_at": "2021-01-01T00:00:00Z", "end_at": "2021-01-01T00:30:00Z", "users": [ { "object": "PERSONAL_ACCESS_TOKEN", "id": "00000000-0000-4000-8000-000000000000", "email": "john.doe@gmail.com", "first_name": "John", "last_name": "Doe", "full_name": "John Doe", "internal_notes": "Internal notes for the user.", "status": "active", "phone": "123456789", "avatar_url": "https://picsum.photos/300", "relationship": "owner", "sso_users": [ … ], "is_super": true } ] } ], "meta": { "group_id": "00000000-0000-4000-8000-000000000000", "company_id": "00000000-0000-4000-8000-000000000000", "company_team_member_ids": [ "00000000-0000-4000-8000-000000000000" ], "user_ids": [ "00000000-0000-4000-8000-000000000000" ], "appointment_id": "00000000-0000-4000-8000-000000000000", "start_at": "2021-06-30T20:30:00Z", "end_at": "2021-06-30T21:30:00Z", "timezone": "CST", "is_twilight": true, "interval": 30, "duration": 30, "current_page": 1, "timeframe": "DAY", "timeframe_period": { "startDate": "2025-04-01T05:59:59.999999Z", "endDate": "2025-04-01T05:59:59.999999Z", "startDateIncluded": true, "endDateIncluded": true }, "from": 1, "last_page": 4, "links": [ { "url": "https://admin.aryeo.test/api/v1/companies?page=2", "label": "2", "active": true } ], "path": "https://api.aryeo.com/v1/{path}", "per_page": 15, "to": 15, "total": 50 }, "links": { "first": "https://api.aryeo.com/v1/{path}?page=1", "last": "https://api.aryeo.com/v1/{path}?page=10", "prev": "https://api.aryeo.com/v1/{path}?page=2", "next": "https://api.aryeo.com/v1/{path}?page=3" }, "timestamp": "2021-06-30T20:30:00Z" }

List schedule item groupings.

Request

List schedule item groupings.

undocumented: true
external: true
const resp = await fetch(
  `https://docs.aryeo.com/_mock/api/aryeo/scheduling/item-groupings`,
  {
    method: 'GET',
    headers: {
      Authorization: 'Bearer <YOUR_TOKEN_HERE>'
    }
  }
);

const data = await resp.text();
console.log(data);

Responses

200

Bodyapplication/json
object
Response
application/json
{}

Tags

Operations related to tags.

Operations

Tasks

Operations related to tasks.

Operations

Users

Operations related to users.

Operations

Videos

Operations related to videos.

Operations