Couplr Couplr developers
API v1 · API reference · explained by Flip

Lookup lists

Short lists of the job types, technicians, tags, lead sources and market segments a job refers to by id.

View Markdown

Base URL: https://couplrfsm.com/api/v1. Conventions shared by every endpoint (examples, ids, dates, money) are on the API reference page. Errors, pagination and idempotency are in Errors, limits and retries.

List job types#

GET /api/v1/job-types · requires the jobs:read ability

The company's job types, by name. Not paginated.

Example request

curl "https://couplrfsm.com/api/v1/job-types" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example response (200)

{
    "data": [
        {
            "id": 1,
            "name": "Repair"
        }
    ]
}

Errors

Status When
401 No key (api_key_missing), the key is unknown or revoked (api_key_invalid), the key had an end date that has passed (api_key_expired), or the key belongs to a private trial sandbox whose access window has ended (sandbox_expired).
403 The key lacks the ability this endpoint needs (ability_missing), no admin user is left to act for the key (no_acting_admin), or the company's account is not yet verified.
429 Too many requests (rate_limited). Wait Retry-After seconds.

List technicians#

GET /api/v1/technicians · requires the jobs:read ability

Technicians a job can be assigned to. Use an id as assigned_tech_id, in assigned_tech_ids or as lead_tech_id. Not paginated.

Example request

curl "https://couplrfsm.com/api/v1/technicians" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example response (200)

{
    "data": [
        {
            "id": 1,
            "name": "Repair"
        }
    ]
}

Errors

Status When
401 No key (api_key_missing), the key is unknown or revoked (api_key_invalid), the key had an end date that has passed (api_key_expired), or the key belongs to a private trial sandbox whose access window has ended (sandbox_expired).
403 The key lacks the ability this endpoint needs (ability_missing), no admin user is left to act for the key (no_acting_admin), or the company's account is not yet verified.
429 Too many requests (rate_limited). Wait Retry-After seconds.

List tags#

GET /api/v1/tags · requires the jobs:read ability

Tags that can be put on a job with tag_ids. Not paginated.

Example request

curl "https://couplrfsm.com/api/v1/tags" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example response (200)

{
    "data": [
        {
            "id": 1,
            "name": "Repair"
        }
    ]
}

Errors

Status When
401 No key (api_key_missing), the key is unknown or revoked (api_key_invalid), the key had an end date that has passed (api_key_expired), or the key belongs to a private trial sandbox whose access window has ended (sandbox_expired).
403 The key lacks the ability this endpoint needs (ability_missing), no admin user is left to act for the key (no_acting_admin), or the company's account is not yet verified.
429 Too many requests (rate_limited). Wait Retry-After seconds.

List lead sources#

GET /api/v1/lead-sources · requires the jobs:read ability

Where customers come from. Use an id as lead_source_id. Not paginated.

Example request

curl "https://couplrfsm.com/api/v1/lead-sources" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example response (200)

{
    "data": [
        {
            "id": 1,
            "name": "Repair"
        }
    ]
}

Errors

Status When
401 No key (api_key_missing), the key is unknown or revoked (api_key_invalid), the key had an end date that has passed (api_key_expired), or the key belongs to a private trial sandbox whose access window has ended (sandbox_expired).
403 The key lacks the ability this endpoint needs (ability_missing), no admin user is left to act for the key (no_acting_admin), or the company's account is not yet verified.
429 Too many requests (rate_limited). Wait Retry-After seconds.

List market segments#

GET /api/v1/market-segments · requires the jobs:read ability

The company's market segments. Use an id as market_segment_id. Not paginated.

Example request

curl "https://couplrfsm.com/api/v1/market-segments" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example response (200)

{
    "data": [
        {
            "id": 1,
            "name": "Repair"
        }
    ]
}

Errors

Status When
401 No key (api_key_missing), the key is unknown or revoked (api_key_invalid), the key had an end date that has passed (api_key_expired), or the key belongs to a private trial sandbox whose access window has ended (sandbox_expired).
403 The key lacks the ability this endpoint needs (ability_missing), no admin user is left to act for the key (no_acting_admin), or the company's account is not yet verified.
429 Too many requests (rate_limited). Wait Retry-After seconds.

Copy this page as Markdown

Your browser blocked automatic copying. The complete page is selected below. Press Ctrl+C (Cmd+C on a Mac) to copy it.