The Orbit4 API

Introduction

Base URL: https://api.orbit4.org

The Orbit4 API is a public-facing API intended to be used by Orbit4 partners to enable their customers to use the Orbit4 platform while ensuring seamless data synchronization with their respective systems.

This API is structured according to key RESTful principles, selectively incorporating guidelines from the JSON API Specification. We accept request data for POST and PUT methods in two formats: application/x-www-form-urlencoded and application/json. Every response from the API, including error notifications, is formatted in JSON.

When errors occur, they are signaled through a specific HTTP status code accompanied by an error object in the response. This object contains a distinctive error code as a string and a user-friendly message, designed to be easily understood by end users.

Authenticating requests

To authenticate requests, include an Authorization header with the value "Bearer {YOUR_AUTH_KEY}".

All authenticated endpoints are marked with a requires authentication badge in the documentation below.

You can retrieve your token by navigating to the API Tokens section within your profile menu and then clicking on Generate API Token.

Assets

The following set of endpoints are engineered for efficient management of your clubs' asset registers on the Orbit4 platform. They simplify the process of creating, updating, and even deleting assets that are no longer needed within your gym operator accounts. The main purpose of these operations is facilitating the synchronization of your system's assets with Orbit4.

Search for assets.

GET

https://api.orbit4.org

/v1/assets

requires authentication

This endpoint allows you to search for assets within the specified gym operator account. You can filter the results by club specifying the user_id and other optional parameters.

Headers

Authorization

Example:

Bearer client-admin-test-token

Content-Type

Example:

application/json

Query Parameters

user_id

integer

required

The ID of the gym operator the assets belong to.

Example:

string

Search for assets by qr_code, brand, range, or product name.

qr_code

string

Filter assets by qr code.

sort

string

Results can be sorted by the following fields:

id
qr_code
installation_date
manufacturing_date
warranty_end_date
created_at

The default sorting order is ascending, but the direction can be reversed by prefixing a dash (-) like so: ?sort=-id

metadata[metadata_key]

string

Filter results by metadata. Replace metadata_key with the key of the metadata you want to filter by.

page

integer

The page number of results to be returned.

per_page

integer

The number of results to be returned for each page of results.

Response Fields

data

array

An array of paginated items.

object

An object representing a paginated item.

integer

The unique identifier for the asset within the Orbit4 system.

brand

string

The brand of the asset.

range

string

The range of the asset.

product

string

The name of the product.

product_id

integer

The unique identifier for the product within the Orbit4 system.

qr_code

string

The qr code number used on the sticker of the equipment.

serial_number

string

The manufacturer serial number of the equipment.

installation_date

string

The installation date of the equipment.

manufacturing_date

string

The manufacturing date of the equipment.

warranty_end_date

string

The warranty end date of the equipment.

current_spend

string

The current spend in services for the equipment.

max_spend

string

The maximum spend in services for the equipment until it's recommended to replace it.

fitness_product

boolean

A boolean indicating whether the asset is a fitness equipment.

has_odometer

boolean

A boolean indicating whether the asset has an odometer.

residual_price

string

The residual value of the asset.

image

object

An object representing the image of the asset

created_at

string

The date and time the asset was created.

links

object

Pagination links.

Fetch asset details.

GET

https://api.orbit4.org

/v1/assets/{asset}

requires authentication

This endpoint allows you to retrieve details of a specific asset by their ID.

Headers

Authorization

Example:

Bearer client-admin-test-token

Content-Type

Example:

application/json

URL Parameters

asset

string

required

The ID of the asset.

Example:

Response Fields

data

object

integer

The unique identifier for the asset within the Orbit4 system.

brand

string

The brand of the asset.

range

string

The range of the asset.

product

string

The name of the product.

product_id

integer

The unique identifier for the product within the Orbit4 system.

qr_code

string

The qr code number used on the sticker of the equipment.

serial_number

string

The manufacturer serial number of the equipment.

installation_date

string

The installation date of the equipment.

manufacturing_date

string

The manufacturing date of the equipment.

warranty_end_date

string

The warranty end date of the equipment.

current_spend

string

The current spend in services for the equipment.

max_spend

string

The maximum spend in services for the equipment until it's recommended to replace it.

fitness_product

boolean

A boolean indicating whether the asset is a fitness equipment.

has_odometer

boolean

A boolean indicating whether the asset has an odometer.

residual_price

string

The residual value of the asset.

image

object

An object representing the image of the asset

created_at

string

The date and time the asset was created.

Example request:

curl --request GET \
    --get "https://api.orbit4.org/v1/assets/2" \
    --header "Authorization: Bearer client-admin-test-token" \
    --header "Content-Type: application/json"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 60
                                                                                                                    x-ratelimit-remaining
                                                            : 52

{
    "data": {
        "id": 2,
        "brand": "Hammer Strength",
        "range": "Plateloaded Iso-Lateral",
        "product": "Seated Leg Press",
        "product_id": 5,
        "qr_code": "O4-376",
        "serial_number": "MSN-561",
        "installation_date": "19/02/2022",
        "manufacturing_date": "19/02/2021",
        "warranty_end_date": "19/02/2027",
        "current_spend": "£0",
        "max_spend": "£2,438.88",
        "fitness_product": 1,
        "has_odometer": 1,
        "residual_price": "£731.64",
        "image": null,
        "metadata": [],
        "created_at": "2025-02-19T14:47:12+00:00"
    }
}

Create new asset.

POST

https://api.orbit4.org

/v1/assets

requires authentication

This endpoint allows you to add a new asset to the gym operator account. The user_id must be specified when adding a new asset.

Headers

Authorization

Example:

Bearer client-admin-test-token

Content-Type

Example:

application/json

Body Parameters

user_id

integer

required

The ID of the gym operator the assets belong to.

Example:

qr_code

string

required

The qr code number used on the sticker of the equipment.

Example:

O4-123456

serial_number

string

The manufacturer serial number of the equipment.

Example:

123456

installation_date

string

The installation date of the equipment.

Example:

2025-02-19

manufacturing_date

string

The manufacturing date of the equipment.

Example:

2025-02-19

warranty_end_date

string

The warranty end date of the equipment.

Example:

2025-02-19

brand

string

The brand of the equipment. This field will be automatically populated if the product_id is provided.

Example:

Life Fitness

range

string

The model/range of the equipment. This field will be automatically populated if the product_id is provided.

Example:

Signature Series

product

string

The name of the equipment. This field will be automatically populated if the product_id is provided.

Example:

Chest Press

product_id

integer

The ID of the equipment in the Orbit4 database.

Example:

metadata

string

A JSON object with metadata, which can be used for filtering. This will also be included in API responses and webhook payloads.

Example:

{"integration_id":"ABC123"}

Response Fields

data

object

integer

The unique identifier for the asset within the Orbit4 system.

brand

string

The brand of the asset.

range

string

The range of the asset.

product

string

The name of the product.

product_id

integer

The unique identifier for the product within the Orbit4 system.

qr_code

string

The qr code number used on the sticker of the equipment.

serial_number

string

The manufacturer serial number of the equipment.

installation_date

string

The installation date of the equipment.

manufacturing_date

string

The manufacturing date of the equipment.

warranty_end_date

string

The warranty end date of the equipment.

current_spend

string

The current spend in services for the equipment.

max_spend

string

The maximum spend in services for the equipment until it's recommended to replace it.

fitness_product

boolean

A boolean indicating whether the asset is a fitness equipment.

has_odometer

boolean

A boolean indicating whether the asset has an odometer.

residual_price

string

The residual value of the asset.

image

object

An object representing the image of the asset

created_at

string

The date and time the asset was created.

Example request:

curl --request POST \
    "https://api.orbit4.org/v1/assets" \
    --header "Authorization: Bearer client-admin-test-token" \
    --header "Content-Type: application/json" \
    --data "{
    \"user_id\": 2,
    \"qr_code\": \"O4-123456\",
    \"serial_number\": \"123456\",
    \"installation_date\": \"2025-02-19\",
    \"manufacturing_date\": \"2025-02-19\",
    \"warranty_end_date\": \"2025-02-19\",
    \"brand\": \"Life Fitness\",
    \"range\": \"Signature Series\",
    \"product\": \"Chest Press\",
    \"product_id\": 1,
    \"metadata\": \"{\\\"integration_id\\\":\\\"ABC123\\\"}\"
}"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 60
                                                                                                                    x-ratelimit-remaining
                                                            : 51

{
    "data": {
        "id": 16,
        "brand": "Life Fitness",
        "range": "IC7 Spin Bike",
        "product": "Studio Bike",
        "product_id": 1,
        "qr_code": "O4-123456",
        "serial_number": "123456",
        "installation_date": "19/02/2025",
        "manufacturing_date": "19/02/2025",
        "warranty_end_date": "19/02/2025",
        "current_spend": "£0",
        "max_spend": "£0",
        "fitness_product": null,
        "has_odometer": null,
        "residual_price": "£597.58",
        "image": null,
        "metadata": {
            "integration_id": "ABC123"
        },
        "created_at": "2025-02-19T14:47:14+00:00"
    }
}

Update asset.

PUT

https://api.orbit4.org

/v1/assets/{asset}

requires authentication

This endpoint allows you to update details of a specific asset by their ID. Only the fields that need to be updated should be provided.

Headers

Authorization

Example:

Bearer client-admin-test-token

Content-Type

Example:

application/json

URL Parameters

asset

string

required

The ID of the asset.

Example:

Body Parameters

qr_code

string

The qr code number used on the sticker of the equipment.

Example:

O4-123456

serial_number

string

The manufacturer serial number of the equipment.

Example:

123456

installation_date

string

The installation date of the equipment.

Example:

2025-02-19

manufacturing_date

string

The manufacturing date of the equipment.

Example:

2025-02-19

warranty_end_date

string

The warranty end date of the equipment.

Example:

2025-02-19

brand

string

The brand of the equipment. This field will be automatically populated if the product_id is provided.

Example:

Life Fitness

range

string

The model/range of the equipment. This field will be automatically populated if the product_id is provided.

Example:

Signature Series

product

string

The name of the equipment. This field will be automatically populated if the product_id is provided.

Example:

Chest Press

product_id

integer

The ID of the equipment in the Orbit4 database.

Example:

metadata

string

A JSON object with metadata, which can be used for filtering. This will also be included in API responses and webhook payloads.

Example:

{"integration_id":"ABC123"}

Response Fields

data

object

integer

The unique identifier for the asset within the Orbit4 system.

brand

string

The brand of the asset.

range

string

The range of the asset.

product

string

The name of the product.

product_id

integer

The unique identifier for the product within the Orbit4 system.

qr_code

string

The qr code number used on the sticker of the equipment.

serial_number

string

The manufacturer serial number of the equipment.

installation_date

string

The installation date of the equipment.

manufacturing_date

string

The manufacturing date of the equipment.

warranty_end_date

string

The warranty end date of the equipment.

current_spend

string

The current spend in services for the equipment.

max_spend

string

The maximum spend in services for the equipment until it's recommended to replace it.

fitness_product

boolean

A boolean indicating whether the asset is a fitness equipment.

has_odometer

boolean

A boolean indicating whether the asset has an odometer.

residual_price

string

The residual value of the asset.

image

object

An object representing the image of the asset

created_at

string

The date and time the asset was created.

Example request:

curl --request PUT \
    "https://api.orbit4.org/v1/assets/2" \
    --header "Authorization: Bearer client-admin-test-token" \
    --header "Content-Type: application/json" \
    --data "{
    \"qr_code\": \"O4-123456\",
    \"serial_number\": \"123456\",
    \"installation_date\": \"2025-02-19\",
    \"manufacturing_date\": \"2025-02-19\",
    \"warranty_end_date\": \"2025-02-19\",
    \"brand\": \"Life Fitness\",
    \"range\": \"Signature Series\",
    \"product\": \"Chest Press\",
    \"product_id\": 1,
    \"metadata\": \"{\\\"integration_id\\\":\\\"ABC123\\\"}\"
}"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 60
                                                                                                                    x-ratelimit-remaining
                                                            : 50

{
    "data": {
        "id": 2,
        "brand": "Life Fitness",
        "range": "IC7 Spin Bike",
        "product": "Studio Bike",
        "product_id": 1,
        "qr_code": "O4-123456",
        "serial_number": "123456",
        "installation_date": "19/02/2025",
        "manufacturing_date": "19/02/2025",
        "warranty_end_date": "19/02/2025",
        "current_spend": "£0",
        "max_spend": "£2,438.88",
        "fitness_product": 1,
        "has_odometer": 1,
        "residual_price": "£597.58",
        "image": null,
        "metadata": {
            "integration_id": "ABC123"
        },
        "created_at": "2025-02-19T14:47:12+00:00"
    }
}

Delete asset.

DELETE

https://api.orbit4.org

/v1/assets/{asset}

requires authentication

This endpoint allows you to delete a specific asset from your account by their ID.

Headers

Authorization

Example:

Bearer client-admin-test-token

Content-Type

Example:

application/json

URL Parameters

asset

string

required

The ID of the asset.

Example:

Example request:

curl --request DELETE \
    "https://api.orbit4.org/v1/assets/2" \
    --header "Authorization: Bearer client-admin-test-token" \
    --header "Content-Type: application/json"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    x-ratelimit-limit
                                                            : 60
                                                                                                                    x-ratelimit-remaining
                                                            : 49

[Empty response]

Contracts

The following set of endpoints are designed to facilitate the management of your service contracts between your gym operators and service providers on the Orbit4 platform. They simplify the process of searching and creating contracts.

Search for contracts.

GET

https://api.orbit4.org

/v1/contracts

requires authentication

This endpoint allows you to search for contracts within the specified user account. You can filter the results by gym operator, service provider or a specific asset.

Headers

Authorization

Example:

Bearer client-admin-test-token

Content-Type

Example:

application/json

Query Parameters

gym_operator_id

integer

The ID of the gym operator the service contract belong to.

Example:

service_provider_id

integer

The ID of the service provider the service contract belong to.

Example:

asset_id

integer

The ID of asset to filter contracts by.

Example:

active

boolean

Filter results by active/expired contracts.

Example:

sort

string

Results can be sorted by the following fields:

id
start_date
created_at

The default sorting order is ascending, but the direction can be reversed by prefixing a dash (-) like so: ?sort=-id

metadata[metadata_key]

string

Filter results by metadata. Replace metadata_key with the key of the metadata you want to filter by.

page

integer

The page number of results to be returned.

per_page

integer

The number of results to be returned for each page of results.

Response Fields

data

array

An array of paginated items.

object

An object representing a paginated item.

integer

The unique identifier for the contract within the Orbit4 system.

number

string

A user friendly identifier for the contract.

type

string

The type of contract.

gym_operator

object

An object representing the gym operator linked to the contract.

integer

The unique identifier for the user within the Orbit4 system.

first_name

string

The first name of the user.

last_name

string

The last name of the user.

string

The email address of the user.

role

string

The role of the user.

company

object

An object representing the company the user is associated with.

integer

The unique identifier for the company within the Orbit4 system.

name

string

The name of the company.

address

string

The first line of the company's address.

address_2

string

The second line of the company's address.

address_3

string

The third line of the company's address.

city

string

The city of the company's address.

country

string

The country of the company's address.

postcode

string

The postcode of the company's address.

created_at

string

The date and time the company was created.

language

string

The language the user prefers to use.

email_verified_at

string

The date and time the user verified their email address.

created_at

string

The date and time the user was created.

service_provider

object

An object representing the service provider linked to the contract.

integer

The unique identifier for the user within the Orbit4 system.

first_name

string

The first name of the user.

last_name

string

The last name of the user.

string

The email address of the user.

role

string

The role of the user.

company

object

An object representing the company the user is associated with.

integer

The unique identifier for the company within the Orbit4 system.

name

string

The name of the company.

address

string

The first line of the company's address.

address_2

string

The second line of the company's address.

address_3

string

The third line of the company's address.

city

string

The city of the company's address.

country

string

The country of the company's address.

postcode

string

The postcode of the company's address.

created_at

string

The date and time the company was created.

language

string

The language the user prefers to use.

email_verified_at

string

The date and time the user verified their email address.

created_at

string

The date and time the user was created.

active

boolean

A boolean indicating whether the contract is currently active.

start_date

string

The date the contract starts.

end_date

string

The date the contract ends.

items

array

An array of the assets included in the contract.

object

An object representing an asset.

integer

The unique identifier for the asset within the Orbit4 system.

brand

string

The brand of the asset.

range

string

The range of the asset.

product

string

The name of the product.

product_id

integer

The unique identifier for the product within the Orbit4 system.

qr_code

string

The qr code number used on the sticker of the equipment.

serial_number

string

The manufacturer serial number of the equipment.

installation_date

string

The installation date of the equipment.

manufacturing_date

string

The manufacturing date of the equipment.

warranty_end_date

string

The warranty end date of the equipment.

current_spend

string

The current spend in services for the equipment.

max_spend

string

The maximum spend in services for the equipment until it's recommended to replace it.

fitness_product

boolean

A boolean indicating whether the asset is a fitness equipment.

has_odometer

boolean

A boolean indicating whether the asset has an odometer.

residual_price

string

The residual value of the asset.

image

object

An object representing the image of the asset

created_at

string

The date and time the asset was created.

links

object

Pagination links.

Create new contract.

POST

https://api.orbit4.org

/v1/contracts

requires authentication

This endpoint allows you to create a new contract between a gym operator and a service provider.

Headers

Authorization

Example:

Bearer client-admin-test-token

Content-Type

Example:

application/json

Body Parameters

gym_operator_id

integer

required

The ID of the gym operator the service contract belong to.

Example:

service_provider_id

integer

required

The ID of the service provider the service contract belong to.

Example:

start_date

string

required

The date the service contract becomes active. The end date will be a year from this date.

Example:

2025-02-19

type

string

required

The type of service contract.

Must be one of:

Full Annual
Labour only
One-Off Service – Labour Only
Adhoc Call-Out
Lease

Example:

Full Annual

assets

array

An array of assets included in this contract. The assets must belong to the specified gym operator.

metadata

string

A JSON object with metadata, which can be used for filtering. This will also be included in API responses and webhook payloads.

Example:

{"integration_id":"ABC123"}

Response Fields

data

object

integer

The unique identifier for the contract within the Orbit4 system.

number

string

A user friendly identifier for the contract.

type

string

The type of contract.

gym_operator

object

An object representing the gym operator linked to the contract.

integer

The unique identifier for the user within the Orbit4 system.

first_name

string

The first name of the user.

last_name

string

The last name of the user.

string

The email address of the user.

role

string

The role of the user.

company

object

An object representing the company the user is associated with.

integer

The unique identifier for the company within the Orbit4 system.

name

string

The name of the company.

address

string

The first line of the company's address.

address_2

string

The second line of the company's address.

address_3

string

The third line of the company's address.

city

string

The city of the company's address.

country

string

The country of the company's address.

postcode

string

The postcode of the company's address.

created_at

string

The date and time the company was created.

language

string

The language the user prefers to use.

email_verified_at

string

The date and time the user verified their email address.

created_at

string

The date and time the user was created.

service_provider

object

An object representing the service provider linked to the contract.

integer

The unique identifier for the user within the Orbit4 system.

first_name

string

The first name of the user.

last_name

string

The last name of the user.

string

The email address of the user.

role

string

The role of the user.

company

object

An object representing the company the user is associated with.

integer

The unique identifier for the company within the Orbit4 system.

name

string

The name of the company.

address

string

The first line of the company's address.

address_2

string

The second line of the company's address.

address_3

string

The third line of the company's address.

city

string

The city of the company's address.

country

string

The country of the company's address.

postcode

string

The postcode of the company's address.

created_at

string

The date and time the company was created.

language

string

The language the user prefers to use.

email_verified_at

string

The date and time the user verified their email address.

created_at

string

The date and time the user was created.

active

boolean

A boolean indicating whether the contract is currently active.

start_date

string

The date the contract starts.

end_date

string

The date the contract ends.

items

array

An array of the assets included in the contract.

object

An object representing an asset.

integer

The unique identifier for the asset within the Orbit4 system.

brand

string

The brand of the asset.

range

string

The range of the asset.

product

string

The name of the product.

product_id

integer

The unique identifier for the product within the Orbit4 system.

qr_code

string

The qr code number used on the sticker of the equipment.

serial_number

string

The manufacturer serial number of the equipment.

installation_date

string

The installation date of the equipment.

manufacturing_date

string

The manufacturing date of the equipment.

warranty_end_date

string

The warranty end date of the equipment.

current_spend

string

The current spend in services for the equipment.

max_spend

string

The maximum spend in services for the equipment until it's recommended to replace it.

fitness_product

boolean

A boolean indicating whether the asset is a fitness equipment.

has_odometer

boolean

A boolean indicating whether the asset has an odometer.

residual_price

string

The residual value of the asset.

image

object

An object representing the image of the asset

created_at

string

The date and time the asset was created.

Example request:

curl --request POST \
    "https://api.orbit4.org/v1/contracts" \
    --header "Authorization: Bearer client-admin-test-token" \
    --header "Content-Type: application/json" \
    --data "{
    \"gym_operator_id\": 2,
    \"service_provider_id\": 3,
    \"start_date\": \"2025-02-19\",
    \"type\": \"Full Annual\",
    \"assets\": [
        1
    ],
    \"metadata\": \"{\\\"integration_id\\\":\\\"ABC123\\\"}\"
}"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 60
                                                                                                                    x-ratelimit-remaining
                                                            : 47

{
    "data": {
        "id": 2,
        "number": "WSGE1",
        "type": "Full Annual",
        "gym_operator": {
            "id": 2,
            "first_name": "Vladimir",
            "last_name": "Becker",
            "email": "[email protected]",
            "role": "gym_operator",
            "company": {
                "id": 1,
                "name": "PulseForge Fitness",
                "address": "35123 Runolfsson Valleys",
                "address_2": null,
                "address_3": null,
                "city": "Lake Osborne",
                "country": "UK",
                "postcode": "24375-0439",
                "created_at": "2025-02-19T14:47:10+00:00"
            },
            "site_name": "London Bridge",
            "language": "en",
            "email_verified_at": "2025-02-19T14:47:11+00:00",
            "metadata": [],
            "created_at": "2025-02-19T14:47:11+00:00"
        },
        "service_provider": {
            "id": 3,
            "first_name": "Susie",
            "last_name": "Walter",
            "email": "[email protected]",
            "role": "gym_operator",
            "company": {
                "id": 1,
                "name": "PulseForge Fitness",
                "address": "35123 Runolfsson Valleys",
                "address_2": null,
                "address_3": null,
                "city": "Lake Osborne",
                "country": "UK",
                "postcode": "24375-0439",
                "created_at": "2025-02-19T14:47:10+00:00"
            },
            "site_name": "Notthing Hill Gate",
            "language": "en",
            "email_verified_at": "2025-02-19T14:47:11+00:00",
            "metadata": [],
            "created_at": "2025-02-19T14:47:11+00:00"
        },
        "active": true,
        "start_date": "2025-02-19",
        "end_date": "2026-02-19",
        "metadata": {
            "integration_id": "ABC123"
        },
        "created_at": "2025-02-19T14:47:14+00:00"
    }
}

Fetch contract details.

GET

https://api.orbit4.org

/v1/contracts/{contract}

requires authentication

This endpoint allows you to retrieve details of a specific contract by their ID.

Headers

Authorization

Example:

Bearer client-admin-test-token

Content-Type

Example:

application/json

URL Parameters

contract

string

required

The ID of the contract.

Example:

Response Fields

data

object

integer

The unique identifier for the contract within the Orbit4 system.

number

string

A user friendly identifier for the contract.

type

string

The type of contract.

gym_operator

object

An object representing the gym operator linked to the contract.

integer

The unique identifier for the user within the Orbit4 system.

first_name

string

The first name of the user.

last_name

string

The last name of the user.

string

The email address of the user.

role

string

The role of the user.

company

object

An object representing the company the user is associated with.

integer

The unique identifier for the company within the Orbit4 system.

name

string

The name of the company.

address

string

The first line of the company's address.

address_2

string

The second line of the company's address.

address_3

string

The third line of the company's address.

city

string

The city of the company's address.

country

string

The country of the company's address.

postcode

string

The postcode of the company's address.

created_at

string

The date and time the company was created.

language

string

The language the user prefers to use.

email_verified_at

string

The date and time the user verified their email address.

created_at

string

The date and time the user was created.

service_provider

object

An object representing the service provider linked to the contract.

integer

The unique identifier for the user within the Orbit4 system.

first_name

string

The first name of the user.

last_name

string

The last name of the user.

string

The email address of the user.

role

string

The role of the user.

company

object

An object representing the company the user is associated with.

integer

The unique identifier for the company within the Orbit4 system.

name

string

The name of the company.

address

string

The first line of the company's address.

address_2

string

The second line of the company's address.

address_3

string

The third line of the company's address.

city

string

The city of the company's address.

country

string

The country of the company's address.

postcode

string

The postcode of the company's address.

created_at

string

The date and time the company was created.

language

string

The language the user prefers to use.

email_verified_at

string

The date and time the user verified their email address.

created_at

string

The date and time the user was created.

active

boolean

A boolean indicating whether the contract is currently active.

start_date

string

The date the contract starts.

end_date

string

The date the contract ends.

items

array

An array of the assets included in the contract.

object

An object representing an asset.

integer

The unique identifier for the asset within the Orbit4 system.

brand

string

The brand of the asset.

range

string

The range of the asset.

product

string

The name of the product.

product_id

integer

The unique identifier for the product within the Orbit4 system.

qr_code

string

The qr code number used on the sticker of the equipment.

serial_number

string

The manufacturer serial number of the equipment.

installation_date

string

The installation date of the equipment.

manufacturing_date

string

The manufacturing date of the equipment.

warranty_end_date

string

The warranty end date of the equipment.

current_spend

string

The current spend in services for the equipment.

max_spend

string

The maximum spend in services for the equipment until it's recommended to replace it.

fitness_product

boolean

A boolean indicating whether the asset is a fitness equipment.

has_odometer

boolean

A boolean indicating whether the asset has an odometer.

residual_price

string

The residual value of the asset.

image

object

An object representing the image of the asset

created_at

string

The date and time the asset was created.

Example request:

curl --request GET \
    --get "https://api.orbit4.org/v1/contracts/1" \
    --header "Authorization: Bearer client-admin-test-token" \
    --header "Content-Type: application/json"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 60
                                                                                                                    x-ratelimit-remaining
                                                            : 46

{
    "data": {
        "id": 1,
        "number": "WSGE123",
        "type": "",
        "gym_operator": {
            "id": 2,
            "first_name": "Vladimir",
            "last_name": "Becker",
            "email": "[email protected]",
            "role": "gym_operator",
            "company": {
                "id": 1,
                "name": "PulseForge Fitness",
                "address": "35123 Runolfsson Valleys",
                "address_2": null,
                "address_3": null,
                "city": "Lake Osborne",
                "country": "UK",
                "postcode": "24375-0439",
                "created_at": "2025-02-19T14:47:10+00:00"
            },
            "site_name": "London Bridge",
            "language": "en",
            "email_verified_at": "2025-02-19T14:47:11+00:00",
            "metadata": [],
            "created_at": "2025-02-19T14:47:11+00:00"
        },
        "service_provider": {
            "id": 4,
            "first_name": "Mathias",
            "last_name": "Bogan",
            "email": "[email protected]",
            "role": "service_provider",
            "company": {
                "id": 2,
                "name": "The Gym Fixers",
                "address": "9199 Wilkinson Cape Suite 748",
                "address_2": null,
                "address_3": null,
                "city": "North Malachiton",
                "country": "UK",
                "postcode": "29910",
                "created_at": "2025-02-19T14:47:10+00:00"
            },
            "site_name": null,
            "language": "en",
            "email_verified_at": "2025-02-19T14:47:11+00:00",
            "metadata": [],
            "created_at": "2025-02-19T14:47:11+00:00"
        },
        "active": true,
        "start_date": "2025-02-18",
        "end_date": "2026-02-18",
        "assets": [
            {
                "id": 1,
                "brand": "Life Fitness",
                "range": "IC7 Spin Bike",
                "product": "Studio Bike",
                "product_id": 1,
                "qr_code": "O4-000",
                "serial_number": "MSN-467",
                "installation_date": "19/02/2022",
                "manufacturing_date": "19/02/2021",
                "warranty_end_date": "19/02/2027",
                "current_spend": "£0",
                "max_spend": "£5,971.87",
                "fitness_product": 1,
                "has_odometer": 1,
                "residual_price": "£169.65",
                "image": null,
                "metadata": [],
                "created_at": "2025-02-19T14:47:12+00:00"
            },
            {
                "id": 2,
                "brand": "Hammer Strength",
                "range": "Plateloaded Iso-Lateral",
                "product": "Seated Leg Press",
                "product_id": 5,
                "qr_code": "O4-376",
                "serial_number": "MSN-561",
                "installation_date": "19/02/2022",
                "manufacturing_date": "19/02/2021",
                "warranty_end_date": "19/02/2027",
                "current_spend": "£0",
                "max_spend": "£2,438.88",
                "fitness_product": 1,
                "has_odometer": 1,
                "residual_price": "£731.64",
                "image": null,
                "metadata": [],
                "created_at": "2025-02-19T14:47:12+00:00"
            },
            {
                "id": 3,
                "brand": "Hammer Strength",
                "range": "Plateloaded Iso-Lateral",
                "product": "Seated Leg Press",
                "product_id": 5,
                "qr_code": "O4-573",
                "serial_number": "MSN-642",
                "installation_date": "19/02/2022",
                "manufacturing_date": "19/02/2021",
                "warranty_end_date": "19/02/2027",
                "current_spend": "£0",
                "max_spend": "£4,595.03",
                "fitness_product": 0,
                "has_odometer": 1,
                "residual_price": "£731.64",
                "image": null,
                "metadata": [],
                "created_at": "2025-02-19T14:47:12+00:00"
            },
            {
                "id": 4,
                "brand": "Life Fitness",
                "range": "Signature",
                "product": "Chest Press",
                "product_id": 2,
                "qr_code": "O4-818",
                "serial_number": "MSN-760",
                "installation_date": "19/02/2022",
                "manufacturing_date": "19/02/2021",
                "warranty_end_date": "19/02/2027",
                "current_spend": "£0",
                "max_spend": "£9,290.30",
                "fitness_product": 1,
                "has_odometer": 0,
                "residual_price": "£765.78",
                "image": null,
                "metadata": [],
                "created_at": "2025-02-19T14:47:12+00:00"
            },
            {
                "id": 5,
                "brand": "Life Fitness",
                "range": "Signature",
                "product": "Chest Press",
                "product_id": 2,
                "qr_code": "O4-205",
                "serial_number": "MSN-650",
                "installation_date": "19/02/2022",
                "manufacturing_date": "19/02/2021",
                "warranty_end_date": "19/02/2027",
                "current_spend": "£0",
                "max_spend": "£6,521.87",
                "fitness_product": 0,
                "has_odometer": 1,
                "residual_price": "£765.78",
                "image": null,
                "metadata": [],
                "created_at": "2025-02-19T14:47:13+00:00"
            },
            {
                "id": 6,
                "brand": "Life Fitness",
                "range": "Signature",
                "product": "Chest Press",
                "product_id": 2,
                "qr_code": "O4-783",
                "serial_number": "MSN-567",
                "installation_date": "19/02/2022",
                "manufacturing_date": "19/02/2021",
                "warranty_end_date": "19/02/2027",
                "current_spend": "£0",
                "max_spend": "£9,749.03",
                "fitness_product": 0,
                "has_odometer": 1,
                "residual_price": "£765.78",
                "image": null,
                "metadata": [],
                "created_at": "2025-02-19T14:47:13+00:00"
            },
            {
                "id": 7,
                "brand": "Hammer Strength",
                "range": "Plateloaded Iso-Lateral",
                "product": "Seated Leg Press",
                "product_id": 5,
                "qr_code": "O4-973",
                "serial_number": "MSN-126",
                "installation_date": "19/02/2022",
                "manufacturing_date": "19/02/2021",
                "warranty_end_date": "19/02/2027",
                "current_spend": "£0",
                "max_spend": "£5,376.09",
                "fitness_product": 0,
                "has_odometer": 0,
                "residual_price": "£731.64",
                "image": null,
                "metadata": [],
                "created_at": "2025-02-19T14:47:13+00:00"
            },
            {
                "id": 8,
                "brand": "Life Fitness",
                "range": "Signature",
                "product": "Chest Press",
                "product_id": 2,
                "qr_code": "O4-848",
                "serial_number": "MSN-739",
                "installation_date": "19/02/2022",
                "manufacturing_date": "19/02/2021",
                "warranty_end_date": "19/02/2027",
                "current_spend": "£0",
                "max_spend": "£8,760.54",
                "fitness_product": 0,
                "has_odometer": 0,
                "residual_price": "£765.78",
                "image": null,
                "metadata": [],
                "created_at": "2025-02-19T14:47:13+00:00"
            },
            {
                "id": 9,
                "brand": "Life Fitness",
                "range": "IC7 Spin Bike",
                "product": "Studio Bike",
                "product_id": 1,
                "qr_code": "O4-993",
                "serial_number": "MSN-909",
                "installation_date": "19/02/2022",
                "manufacturing_date": "19/02/2021",
                "warranty_end_date": "19/02/2027",
                "current_spend": "£0",
                "max_spend": "£3,437.80",
                "fitness_product": 0,
                "has_odometer": 0,
                "residual_price": "£169.65",
                "image": null,
                "metadata": [],
                "created_at": "2025-02-19T14:47:13+00:00"
            },
            {
                "id": 10,
                "brand": "Hammer Strength",
                "range": "Plateloaded Iso-Lateral",
                "product": "Seated Leg Press",
                "product_id": 5,
                "qr_code": "O4-957",
                "serial_number": "MSN-608",
                "installation_date": "19/02/2022",
                "manufacturing_date": "19/02/2021",
                "warranty_end_date": "19/02/2027",
                "current_spend": "£0",
                "max_spend": "£6,876.70",
                "fitness_product": 0,
                "has_odometer": 0,
                "residual_price": "£731.64",
                "image": null,
                "metadata": [],
                "created_at": "2025-02-19T14:47:13+00:00"
            }
        ],
        "metadata": [],
        "created_at": "2025-02-19T14:47:13+00:00"
    }
}

Media

The following set of endpoints are designed to facilitate the management of media files within the different resources.

Upload media.

POST

https://api.orbit4.org

/v1/media

requires authentication

This endpoint allows you to upload media files to the specified resource. Some media types are single-use, meaning that only one media file can be uploaded for that type on that resource. If a media file already exists for the specified type, it will be replaced with the new one.

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

multipart/form-data

Body Parameters

type

string

required

The type of media to be uploaded.

Must be one of:

image
audio
video
quote
worksheet
purchase_order
invoice

Example:

image

file

required

The file being uploaded.

Example:

/tmp/phpQXeMcl

resource_id

integer

required

The ID of the resource the media is being uploaded for.

Example:

resource_type

string

required

The type of resource the media is being uploaded for.

Must be one of:

asset
ticket

Example:

ticket

Response Fields

data

object

Example request:

curl --request POST \
    "https://api.orbit4.org/v1/media" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: multipart/form-data" \
    --form "type=image"\
    --form "resource_id=1"\
    --form "resource_type=ticket"\
    --form "file=@/tmp/phpQXeMcl"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 60
                                                                                                                    x-ratelimit-remaining
                                                            : 40

{
    "data": {
        "id": 3,
        "url": "https://cdn.orbit4.org/uploads/8199167b5eef35ccc41.82219640.jpg",
        "type": "image",
        "extra_properties": null,
        "created_at": "2025-02-19T14:47:15+00:00"
    }
}

Update media extra properties.

PUT

https://api.orbit4.org

/v1/media/{media}

requires authentication

This endpoint allows you to upload media metadata to the specified resource.

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

URL Parameters

media

string

required

The ID of the media file.

Example:

Body Parameters

extra_properties

object

required

The extra properties to be updated.

Example:

{"approved":true}

Response Fields

data

object

Example request:

curl --request PUT \
    "https://api.orbit4.org/v1/media/2" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --data "{
    \"extra_properties\": \"{\\\"approved\\\":true}\"
}"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 60
                                                                                                                    x-ratelimit-remaining
                                                            : 39

{
    "data": {
        "id": 2,
        "url": "https://cdn.orbit4.org/uploads/quote.pdf",
        "type": "quote",
        "extra_properties": {
            "approved": true
        },
        "created_at": "2025-02-19T14:47:14+00:00"
    }
}

Notes

The following set of endpoints are designed to facilitate the management of ticket notes. accounts.

Create ticket note.

POST

https://api.orbit4.org

/v1/notes

requires authentication

This endpoint allows you to create a new note for the specified ticket.

Headers

Authorization

Example:

Bearer client-admin-test-token

Content-Type

Example:

application/json

Body Parameters

user_id

integer

required

The ID of the author of the note.

Example:

ticket_id

integer

required

The ID of the ticket the note is added to.

Example:

note

string

required

The message of the note.

Example:

Can you please provide more details about the issue?

Response Fields

data

object

integer

The unique identifier for the note within the Orbit4 system.

user

object

An object representing the user who sent the note.

integer

The unique identifier for the user within the Orbit4 system.

first_name

string

The first name of the user.

last_name

string

The last name of the user.

string

The email address of the user.

role

string

The role of the user.

company

object

An object representing the company the user is associated with.

integer

The unique identifier for the company within the Orbit4 system.

name

string

The name of the company.

address

string

The first line of the company's address.

address_2

string

The second line of the company's address.

address_3

string

The third line of the company's address.

city

string

The city of the company's address.

country

string

The country of the company's address.

postcode

string

The postcode of the company's address.

created_at

string

The date and time the company was created.

language

string

The language the user prefers to use.

email_verified_at

string

The date and time the user verified their email address.

created_at

string

The date and time the user was created.

note

string

The content of the note.

is_system

boolean

A boolean indicating whether the note was generated by the system.

created_at

string

The date and time the note was created.

Example request:

curl --request POST \
    "https://api.orbit4.org/v1/notes" \
    --header "Authorization: Bearer client-admin-test-token" \
    --header "Content-Type: application/json" \
    --data "{
    \"user_id\": 2,
    \"ticket_id\": 1,
    \"note\": \"Can you please provide more details about the issue?\"
}"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 60
                                                                                                                    x-ratelimit-remaining
                                                            : 41

{
    "data": {
        "id": 10,
        "user": {
            "id": 2,
            "first_name": "Vladimir",
            "last_name": "Becker",
            "email": "[email protected]",
            "role": "gym_operator",
            "company": {
                "id": 1,
                "name": "PulseForge Fitness",
                "address": "35123 Runolfsson Valleys",
                "address_2": null,
                "address_3": null,
                "city": "Lake Osborne",
                "country": "UK",
                "postcode": "24375-0439",
                "created_at": "2025-02-19T14:47:10+00:00"
            },
            "site_name": "London Bridge",
            "language": "en",
            "email_verified_at": "2025-02-19T14:47:11+00:00",
            "metadata": [],
            "created_at": "2025-02-19T14:47:11+00:00"
        },
        "note": "Can you please provide more details about the issue?",
        "is_system": false,
        "created_at": "2025-02-19T14:47:15+00:00"
    }
}

Tickets

The following set of endpoints are designed to facilitate the management of tickets within your different user accounts. They allow you to search for tickets, fetch specific ticket details, create new tickets, update ticket details, and even change tickets' status. The main purpose of these operations is facilitating the synchronization of your system's tickets with Orbit4.

Search for tickets.

GET

https://api.orbit4.org

/v1/tickets

requires authentication

This endpoint allows you to search for tickets based on specified criteria. The search results will include all tickets that match the criteria.

Headers

Authorization

Example:

Bearer client-admin-test-token

Content-Type

Example:

application/json

Query Parameters

user_id

integer

The ID of the user for whom the tickets are being fetched.

Example:

string

Search for tickets by ticket_number or description.

type

string

Filter tickets by their type.

Must be one of:

standard
ad-hoc
internal
service

status

string

Filter tickets by their status.

Must be one of:

open
parts_required
engineer_deployed
closed

sort

string

Results can be sorted by the following fields:

id
ticket_number
status
created_at

The default sorting order is ascending, but the direction can be reversed by prefixing a dash (-) like so: ?sort=-id

metadata[metadata_key]

string

Filter results by metadata. Replace metadata_key with the key of the metadata you want to filter by.

page

integer

The page number of results to be returned.

per_page

integer

The number of results to be returned for each page of results.

Response Fields

data

array

An array of paginated items.

object

An object representing a paginated item.

integer

The unique identifier for the ticket within the Orbit4 system.

number

string

A user friendly identifier for the ticket.

type

string

The type of ticket.

description

string

A description of the issue.

priority

string

The priority of the ticket based on the state of the equipment.

status

string

The current status of the ticket.

engineer_arrived_at

string

The date and time the engineer arrived at the location.

engineer_deployed_at

string

The date and time the engineer was deployed to the location.

closed_at

string

The date and time the ticket was closed.

service_provider

object

An object representing the service provider linked to the ticket.

integer

The unique identifier for the user within the Orbit4 system.

first_name

string

The first name of the user.

last_name

string

The last name of the user.

string

The email address of the user.

role

string

The role of the user.

company

object

An object representing the company the user is associated with.

integer

The unique identifier for the company within the Orbit4 system.

name

string

The name of the company.

address

string

The first line of the company's address.

address_2

string

The second line of the company's address.

address_3

string

The third line of the company's address.

city

string

The city of the company's address.

country

string

The country of the company's address.

postcode

string

The postcode of the company's address.

created_at

string

The date and time the company was created.

language

string

The language the user prefers to use.

email_verified_at

string

The date and time the user verified their email address.

created_at

string

The date and time the user was created.

gym_operator

object

An object representing the gym operator linked to the ticket.

integer

The unique identifier for the user within the Orbit4 system.

first_name

string

The first name of the user.

last_name

string

The last name of the user.

string

The email address of the user.

role

string

The role of the user.

company

object

An object representing the company the user is associated with.

integer

The unique identifier for the company within the Orbit4 system.

name

string

The name of the company.

address

string

The first line of the company's address.

address_2

string

The second line of the company's address.

address_3

string

The third line of the company's address.

city

string

The city of the company's address.

country

string

The country of the company's address.

postcode

string

The postcode of the company's address.

created_at

string

The date and time the company was created.

language

string

The language the user prefers to use.

email_verified_at

string

The date and time the user verified their email address.

created_at

string

The date and time the user was created.

ticket_admin

object

An object representing the ticket admin linked to the ticket.

integer

The unique identifier for the user within the Orbit4 system.

first_name

string

The first name of the user.

last_name

string

The last name of the user.

string

The email address of the user.

role

string

The role of the user.

company

object

An object representing the company the user is associated with.

integer

The unique identifier for the company within the Orbit4 system.

name

string

The name of the company.

address

string

The first line of the company's address.

address_2

string

The second line of the company's address.

address_3

string

The third line of the company's address.

city

string

The city of the company's address.

country

string

The country of the company's address.

postcode

string

The postcode of the company's address.

created_at

string

The date and time the company was created.

language

string

The language the user prefers to use.

email_verified_at

string

The date and time the user verified their email address.

created_at

string

The date and time the user was created.

engineer

object

An object representing the engineer linked to the ticket.

integer

The unique identifier for the user within the Orbit4 system.

first_name

string

The first name of the user.

last_name

string

The last name of the user.

string

The email address of the user.

role

string

The role of the user.

company

object

An object representing the company the user is associated with.

integer

The unique identifier for the company within the Orbit4 system.

name

string

The name of the company.

address

string

The first line of the company's address.

address_2

string

The second line of the company's address.

address_3

string

The third line of the company's address.

city

string

The city of the company's address.

country

string

The country of the company's address.

postcode

string

The postcode of the company's address.

created_at

string

The date and time the company was created.

language

string

The language the user prefers to use.

email_verified_at

string

The date and time the user verified their email address.

created_at

string

The date and time the user was created.

caretaker

object

An object representing the caretaker linked to the ticket.

integer

The unique identifier for the user within the Orbit4 system.

first_name

string

The first name of the user.

last_name

string

The last name of the user.

string

The email address of the user.

role

string

The role of the user.

company

object

An object representing the company the user is associated with.

integer

The unique identifier for the company within the Orbit4 system.

name

string

The name of the company.

address

string

The first line of the company's address.

address_2

string

The second line of the company's address.

address_3

string

The third line of the company's address.

city

string

The city of the company's address.

country

string

The country of the company's address.

postcode

string

The postcode of the company's address.

created_at

string

The date and time the company was created.

language

string

The language the user prefers to use.

email_verified_at

string

The date and time the user verified their email address.

created_at

string

The date and time the user was created.

asset

object

An object representing the asset linked to the ticket.

integer

The unique identifier for the asset within the Orbit4 system.

brand

string

The brand of the asset.

range

string

The range of the asset.

product

string

The name of the product.

product_id

integer

The unique identifier for the product within the Orbit4 system.

qr_code

string

The qr code number used on the sticker of the equipment.

serial_number

string

The manufacturer serial number of the equipment.

installation_date

string

The installation date of the equipment.

manufacturing_date

string

The manufacturing date of the equipment.

warranty_end_date

string

The warranty end date of the equipment.

current_spend

string

The current spend in services for the equipment.

max_spend

string

The maximum spend in services for the equipment until it's recommended to replace it.

fitness_product

boolean

A boolean indicating whether the asset is a fitness equipment.

has_odometer

boolean

A boolean indicating whether the asset has an odometer.

residual_price

string

The residual value of the asset.

image

object

An object representing the image of the asset

created_at

string

The date and time the asset was created.

contract

object

An object representing the contract linked to the ticket.

integer

The unique identifier for the contract within the Orbit4 system.

number

string

A user friendly identifier for the contract.

type

string

The type of contract.

gym_operator

object

An object representing the gym operator linked to the contract.

integer

The unique identifier for the user within the Orbit4 system.

first_name

string

The first name of the user.

last_name

string

The last name of the user.

string

The email address of the user.

role

string

The role of the user.

company

object

An object representing the company the user is associated with.

integer

The unique identifier for the company within the Orbit4 system.

name

string

The name of the company.

address

string

The first line of the company's address.

address_2

string

The second line of the company's address.

address_3

string

The third line of the company's address.

city

string

The city of the company's address.

country

string

The country of the company's address.

postcode

string

The postcode of the company's address.

created_at

string

The date and time the company was created.

language

string

The language the user prefers to use.

email_verified_at

string

The date and time the user verified their email address.

created_at

string

The date and time the user was created.

service_provider

object

An object representing the service provider linked to the contract.

integer

The unique identifier for the user within the Orbit4 system.

first_name

string

The first name of the user.

last_name

string

The last name of the user.

string

The email address of the user.

role

string

The role of the user.

company

object

An object representing the company the user is associated with.

integer

The unique identifier for the company within the Orbit4 system.

name

string

The name of the company.

address

string

The first line of the company's address.

address_2

string

The second line of the company's address.

address_3

string

The third line of the company's address.

city

string

The city of the company's address.

country

string

The country of the company's address.

postcode

string

The postcode of the company's address.

created_at

string

The date and time the company was created.

language

string

The language the user prefers to use.

email_verified_at

string

The date and time the user verified their email address.

created_at

string

The date and time the user was created.

active

boolean

A boolean indicating whether the contract is currently active.

start_date

string

The date the contract starts.

end_date

string

The date the contract ends.

items

array

An array of the assets included in the contract.

object

An object representing an asset.

integer

The unique identifier for the asset within the Orbit4 system.

brand

string

The brand of the asset.

range

string

The range of the asset.

product

string

The name of the product.

product_id

integer

The unique identifier for the product within the Orbit4 system.

qr_code

string

The qr code number used on the sticker of the equipment.

serial_number

string

The manufacturer serial number of the equipment.

installation_date

string

The installation date of the equipment.

manufacturing_date

string

The manufacturing date of the equipment.

warranty_end_date

string

The warranty end date of the equipment.

current_spend

string

The current spend in services for the equipment.

max_spend

string

The maximum spend in services for the equipment until it's recommended to replace it.

fitness_product

boolean

A boolean indicating whether the asset is a fitness equipment.

has_odometer

boolean

A boolean indicating whether the asset has an odometer.

residual_price

string

The residual value of the asset.

image

object

An object representing the image of the asset

created_at

string

The date and time the asset was created.

media

array

An array of objects representing the media linked to the ticket.

object

An object representing an piece of media.

images

array

An array of objects representing the images linked to the ticket.

object

An object representing an image.

notes

array

An array of objects representing the notes linked to the ticket.

object

An object representing a note.

integer

The unique identifier for the note within the Orbit4 system.

user

object

An object representing the user who sent the note.

integer

The unique identifier for the user within the Orbit4 system.

first_name

string

The first name of the user.

last_name

string

The last name of the user.

string

The email address of the user.

role

string

The role of the user.

company

object

An object representing the company the user is associated with.