Skip to main content

Partly Integrations Server (1.0.0)

Download OpenAPI specification:Download

Partly's platform for integrating with our services

integrations.insert

Completes the integration installation and API key generation for a given install. The request must provide the client secret, client ID and the access code generated during the OAuth authorization process

Request Body schema: application/json
required
access_code
required
string (std.string.String)

This is the access code that came as part of the redirect in step 3, access_code is a short code with a 15 minute TTL

client_id
required
string (std.string.String)

This is the identifier for your integration Contact Partly to receive integration client credentials

client_secret
required
string (std.string.String)

This is the secret provided during integration client ID / secret provisioning.

Responses

Request samples

Content type
application/json
{
  • "access_code": "string",
  • "client_id": "string",
  • "client_secret": "string"
}

Response samples

Content type
application/json
{
  • "api_key": "string",
  • "integration_id": "55d7337e-1d0a-49fc-9826-925ba40df035"
}

jobs.get

Fetches a repair job

header Parameters
authorization
required
string (std.string.String)

UTF-8 encoded string

partly-integration-id
required
string <uuid> (uuid.Uuid)

UUID value type

Request Body schema: application/json
required
required
id (object) or external (object) (integrations_server.service.jobs.v1.model.JobIdentityV1)
One of
id
required
string <uuid> (uuid.Uuid)

UUID value type

Responses

Request samples

Content type
application/json
{
  • "identity": {
    }
}

Response samples

Content type
application/json
{
  • "claim_number": { },
  • "external_id": { },
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "images": [
    ],
  • "job_number": { },
  • "site_id": "72771e6a-6f5e-4de4-a5b9-1266c4197811",
  • "status": {
    },
  • "vehicle": { },
  • "work_provider_id": { }
}

jobs.insert

header Parameters
authorization
required
string (std.string.String)

UTF-8 encoded string

partly-integration-id
required
string <uuid> (uuid.Uuid)

UUID value type

Request Body schema: application/json
required
required
object (integrations_server.service.jobs.v1.model.ExternalInsertV1)
required
id (object) or external (object) (integrations_server.service.jobs.v1.model.JobIdentityV1)
required
object (integrations_server.service.jobs.v1.model.IfConflictOnInsert<reflectapi_ex.types_actions.IfExistsUpdateOrReplace>)

Responses

Request samples

Content type
application/json
{
  • "data": {
    },
  • "identity": {
    },
  • "if_": {
    }
}

Response samples

Content type
application/json
{
  • "claim_number": { },
  • "external_id": { },
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "images": [
    ],
  • "job_number": { },
  • "site_id": "72771e6a-6f5e-4de4-a5b9-1266c4197811",
  • "status": {
    },
  • "vehicle": { },
  • "work_provider_id": { }
}

tier1.prepare

Queue up a given vehicle VIN for future use in other Partly services.

header Parameters
authorization
required
string (std.string.String)

UTF-8 encoded string

partly-integration-id
required
string <uuid> (uuid.Uuid)

UUID value type

Request Body schema: application/json
required
required
Array of ChassisNumber (object) or integrations_server.service.tier1.v1.model.LocationV1 (object) (integrations_server.service.tier1.v1.model.VehicleIdentifierV1)

An array of vehicle identifiers to preload. Each identifier object must conform to one of the two structures detailed below (Chassis Number or VRM). Must contain between 1 and 100 identifiers. VRM (License Plate) is recommended over Chassis Number as a VRM lookup often yields better data quality and allows us to disambiguate possible vehicle variants (e.g. trim or color options) more effectively.

Array
One of
chassis_number
required
string (std.string.String)

The vehicle's chassis number (VIN) or Frame Number (Japenese Domestic Market vehicles only)

Responses

Request samples

Content type
application/json
{
  • "identifiers": [
    ]
}

Response samples

Content type
application/json
{ }