List and poll claims

curl --request GET \
  --url https://api.osaconnection.com/v1/claims \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.osaconnection.com/v1/claims', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.osaconnection.com/v1/claims",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.osaconnection.com/v1/claims"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.osaconnection.com/v1/claims")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "3f8a2c61-5b7e-4d2a-9c1e-7a4b2d9e6f10",
      "external_id": "CMS-884512",
      "claim_number": "FL-2026-0091832",
      "test": false,
      "created_at": "2026-09-28T14:32:11Z",
      "updated_at": "2026-09-28T15:05:42Z",
      "assignment": {
        "status": "accepted",
        "adjuster_osa_id": "Xk3pQ9vT2mN8rL5wB7yC1dF4gH6j",
        "responded_at": "2026-09-28T15:05:42Z",
        "rejection_reason": null
      },
      "loss": {
        "date": "2026-09-27",
        "peril": "flood"
      },
      "policy": {
        "number": "8705123456"
      },
      "carrier": {
        "name": "Gulf Coast Mutual Insurance"
      },
      "loss_location": {
        "street": "418 Bayshore Drive",
        "city": "Tampa",
        "state": "FL",
        "zip": "33606"
      },
      "policyholder": {
        "first_name": "Maria",
        "last_name": "Delgado",
        "phone": "8135550142"
      }
    },
    {
      "id": "9b2e4f70-1c3d-4a5b-8e6f-0a1b2c3d4e5f",
      "external_id": "CMS-884530",
      "claim_number": "FL-2026-0091877",
      "test": false,
      "created_at": "2026-09-28T14:40:03Z",
      "updated_at": "2026-09-28T15:12:09Z",
      "assignment": {
        "status": "rejected",
        "adjuster_osa_id": "Rt7uW2eY9iO4pA6sD1fG3hJ5kL8z",
        "responded_at": "2026-09-28T15:12:09Z",
        "rejection_reason": "At capacity this week."
      },
      "loss": {
        "date": "2026-09-27",
        "peril": "flood"
      },
      "policy": {
        "number": "8705127781"
      },
      "carrier": {
        "name": "Gulf Coast Mutual Insurance"
      },
      "loss_location": {
        "street": "77 Davis Boulevard",
        "city": "Tampa",
        "state": "FL",
        "zip": "33606"
      },
      "policyholder": {
        "company_name": "Davis Island Marina LLC",
        "email": "office@davismarina.example.com"
      }
    }
  ],
  "next_cursor": "eyJ0IjoiMjAyNi0wOS0yOFQxNToxMjowOVoiLCJpIjoiOWIyZTRmNzAifQ"
}

Claims

List and poll claims

Lists the claims your firm sent through the API, oldest change first, ordered by updated_at and then id. This is the endpoint to poll for acceptance: call it every 1 to 5 minutes with updated_since rather than polling claims one by one.

What moves updated_at. It changes only when something you can see changes: the claim is created, offered to another adjuster, accepted or rejected. Adjusters’ work on the claim in the app doesn’t move it.

Polling. updated_since is inclusive. Set it to the latest updated_at you have processed minus about one minute, follow next_cursor until it is null, and de-duplicate by id. The overlap means you will see some claims twice; that is expected.

Test claims. Live keys see test claims too, marked test: true, so you can skip them. Test keys see only test claims.

Unknown query parameters are rejected with 422 validation_failed.

GET

claims

List and poll claims

curl --request GET \
  --url https://api.osaconnection.com/v1/claims \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.osaconnection.com/v1/claims', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.osaconnection.com/v1/claims",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.osaconnection.com/v1/claims"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.osaconnection.com/v1/claims")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "3f8a2c61-5b7e-4d2a-9c1e-7a4b2d9e6f10",
      "external_id": "CMS-884512",
      "claim_number": "FL-2026-0091832",
      "test": false,
      "created_at": "2026-09-28T14:32:11Z",
      "updated_at": "2026-09-28T15:05:42Z",
      "assignment": {
        "status": "accepted",
        "adjuster_osa_id": "Xk3pQ9vT2mN8rL5wB7yC1dF4gH6j",
        "responded_at": "2026-09-28T15:05:42Z",
        "rejection_reason": null
      },
      "loss": {
        "date": "2026-09-27",
        "peril": "flood"
      },
      "policy": {
        "number": "8705123456"
      },
      "carrier": {
        "name": "Gulf Coast Mutual Insurance"
      },
      "loss_location": {
        "street": "418 Bayshore Drive",
        "city": "Tampa",
        "state": "FL",
        "zip": "33606"
      },
      "policyholder": {
        "first_name": "Maria",
        "last_name": "Delgado",
        "phone": "8135550142"
      }
    },
    {
      "id": "9b2e4f70-1c3d-4a5b-8e6f-0a1b2c3d4e5f",
      "external_id": "CMS-884530",
      "claim_number": "FL-2026-0091877",
      "test": false,
      "created_at": "2026-09-28T14:40:03Z",
      "updated_at": "2026-09-28T15:12:09Z",
      "assignment": {
        "status": "rejected",
        "adjuster_osa_id": "Rt7uW2eY9iO4pA6sD1fG3hJ5kL8z",
        "responded_at": "2026-09-28T15:12:09Z",
        "rejection_reason": "At capacity this week."
      },
      "loss": {
        "date": "2026-09-27",
        "peril": "flood"
      },
      "policy": {
        "number": "8705127781"
      },
      "carrier": {
        "name": "Gulf Coast Mutual Insurance"
      },
      "loss_location": {
        "street": "77 Davis Boulevard",
        "city": "Tampa",
        "state": "FL",
        "zip": "33606"
      },
      "policyholder": {
        "company_name": "Davis Island Marina LLC",
        "email": "office@davismarina.example.com"
      }
    }
  ],
  "next_cursor": "eyJ0IjoiMjAyNi0wOS0yOFQxNToxMjowOVoiLCJpIjoiOWIyZTRmNzAifQ"
}

Authorizations

Authorization

string

header

required

Send your API key as a bearer token: Authorization: Bearer osa_live_…. Keys are opaque; each belongs to exactly one firm and one purpose. Keys starting with osa_test_ reach only test claims and test accounts. The scopes listed on each operation are the permissions the key needs; GET /v1/me shows the ones your key has.

Query Parameters

updated_since

string<date-time>

Return only claims whose updated_at is at or after this time (inclusive). For polling, use the latest updated_at you have processed minus about one minute, and de-duplicate by id.

assignment_status

enum<string>

Return only claims whose assignment.status has this value. Where the latest offer stands. pending_acceptance: the adjuster hasn't answered yet. accepted: the adjuster accepted the claim. rejected: the adjuster rejected it; you can offer it to another adjuster. unassigned: the claim isn't currently offered to anyone; you can offer it to an adjuster.

Available options:

pending_acceptance,

accepted,

rejected,

unassigned

Example:

"pending_acceptance"

external_id

string

Return the claim with this external_id (your own claim id). Lookups only ever search your own firm, in the key's environment.

Your own id for the claim in your system (for example your claims-management record id). Unique within your firm and the key's environment (test or live), and never changed. No leading or trailing whitespace.

Required string length: 1 - 100

Pattern: ^\S(.*\S)?$

Example:

"CMS-884512"

limit

integer

default:50

Page size. Defaults to 50; at most 200.

Required range: 1 <= x <= 200

cursor

string

The next_cursor from the previous page. Cursors are opaque; send the same filters with each cursor as with the first page.

Required string length: 1 - 512

Response

One page of claims. next_cursor is null on the last page.

One page of claims.

data

object[]

required

The claims on this page, ordered by updated_at, then id.

Show child attributes

next_cursor

string | null

required

Pass this as cursor to get the next page; null on the last page.

Claims

Adjusters

Account

Claims

Adjusters

Account

Health

List and poll claims

Authorizations

Query Parameters

Response