Claimio Partner API

Unclaimed property data in one call

Send a phone number and name. Get back the owner on file, their state property records, and a value estimate your users can see right away.

POST/api/v1/phone-search
Phone number
(949) 000-0000
Full name
John Doe

Illustrative sample only. No API request is made.

200 OK · example2 of 6 records shown
Est. value
$4,618.71
Records
6
States
MN, CA, GA
{
  "request_id": "a4b2634a-e6ad-4d67-a1d0-ae7eaa9c6382",
  "success": true,
  "query": {
    "phone_number": "19490000000",
    "normalized_phone": "9490000000",
    "first_name": "John",
    "last_name": "Doe"
  },
  "candidate_count": 1,
  "result_count": 1,
  "result": {
    "full_name": "John Doe",
    "first_name": "John",
    "middle_name": "",
    "last_name": "Doe",
    "input_match": {
      "score": 200,
      "first_name_match": true,
      "last_name_match": true
    },
    "matched_phone": {
      "number": "9490000000",
      "e164": "+19490000000",
      "display": "(949) 000-0000"
    },
    "addresses": [
      {
        "full": "910 Lake St, Minneapolis, MN 55408",
        "line1": "910 Lake St",
        "city": "Minneapolis",
        "state": "MN",
        "zip": "55408",
        "rank": 1
      },
      {
        "full": "123 Main St, San Francisco, CA 94105",
        "line1": "123 Main St",
        "city": "San Francisco",
        "state": "CA",
        "zip": "94105",
        "rank": 2
      },
      {
        "full": "48 Peachtree Ave, Atlanta, GA 30303",
        "line1": "48 Peachtree Ave",
        "city": "Atlanta",
        "state": "GA",
        "zip": "30303",
        "rank": 3
      }
    ],
    "property_matches": [
      {
        "state_code": "MN",
        "link": "MN_D08C862FEB59",
        "property_id": "MN-5618010",
        "owner_name": "JOHN DOE",
        "owner_relation": "Primary Owner",
        "property_amount": 188.21,
        "property_amount_decimal": "188.21",
        "property_type": "Insurance policy payout",
        "holder_name": "Example Bank, N.A.",
        "owner_address_1": "910 LAKE ST",
        "owner_city": "MINNEAPOLIS",
        "owner_state": "MN",
        "owner_zip_code": "55408",
        "report_year": "2022",
        "last_activity_date": "2020-02-26",
        "matched_address": {
          "full": "910 Lake St, Minneapolis, MN 55408",
          "line1": "910 Lake St",
          "city": "Minneapolis",
          "state": "MN",
          "zip": "55408",
          "rank": 1
        }
      },
      {
        "state_code": "CA",
        "link": "CA_97A36D34DE6D",
        "property_id": "CA-5781769",
        "owner_name": "JOHN DOE",
        "owner_relation": "Primary Owner",
        "property_amount": 490.23,
        "property_amount_decimal": "490.23",
        "property_type": "Utility deposit refund",
        "holder_name": "Example Payroll Services",
        "owner_address_1": "123 MAIN ST",
        "owner_city": "SAN FRANCISCO",
        "owner_state": "CA",
        "owner_zip_code": "94105",
        "report_year": "2020",
        "last_activity_date": "2018-01-12",
        "matched_address": {
          "full": "123 Main St, San Francisco, CA 94105",
          "line1": "123 Main St",
          "city": "San Francisco",
          "state": "CA",
          "zip": "94105",
          "rank": 2
        }
      }
    ],
    "property_match_count": 6,
    "property_total_amount": 4618.71
  },
  "warnings": []
}
What you get back

Everything you need to show a user their money

  1. 01

    Owner match

    We find the person linked to the phone number. Send a first and last name to rank the candidates, and input_match tells you whether they matched the owner on file.

  2. 02

    State property records

    Each record with state, property type, holder, report year and amount.

  3. 03

    Value estimate

    A total across every record, ready to drop into your UI: “The state may be holding $1,850 for you.”

Built for products that already know the phone number

  • Fintech and banking

    Surface found money inside your app and drive engagement.

  • HR and benefits

    Offer employees a free check for unclaimed property as a perk.

  • Wealth and advisory

    Find forgotten assets for clients during onboarding and reviews.

Quickstart

Your first call in two requests

Full documentation is shared once your account is active. Questions: api@claimio.com

  1. 01Get an access token

    shellPOST /api/oauth/token
    curl -X POST https://partner.bluenavy.org/api/oauth/token \
      -H "content-type: application/x-www-form-urlencoded" \
      -d "grant_type=client_credentials" \
      -d "client_id=partner_acme" \
      -d "client_secret=..."
  2. 02Search a phone number

    shellPOST /api/v1/phone-search
    curl -X POST https://partner.bluenavy.org/api/v1/phone-search \
      -H "authorization: Bearer $ACCESS_TOKEN" \
      -H "content-type: application/json" \
      -d '{"phone_number":"19490000000",
           "first_name":"John","last_name":"Doe"}'
Get started

Pay per call, or talk to us about volume

Pay as you go
Usage-based pricingContact us for current rates
  • No minimums, no contract
  • Billed monthly for the calls you make
  • Set a monthly spend limit
  • Sandbox keys free while you build

Over 1,000 calls a month? Ask about volume pricing

Create your API account

No payment details needed today. We’ll review your request and email your sandbox keys.

API questions

What does one call return?

You send a phone number, plus the person’s first and last name if you have them. The call returns the top-ranked person linked to that number, their addresses, every matching state property record, and a total value. If no one is linked to the number, result is null.

How does the name match work?

Names are optional. When you send them, we use them to rank the people linked to the number, and input_match reports whether the first and last name each matched the returned person exactly. Your product decides what to show when they don’t.

Which states are covered?

Searches cover unclaimed property databases in all 50 states and DC.

How does pay as you go billing work?

Once your account is approved for production, calls are billed monthly at usage-based rates. There are no minimums, and you can set a monthly spend limit. Contact us for current pricing.

Can my users recover the money they find?

Yes. On volume plans we can embed Claimio’s claim flow so users can start a recovery without leaving your product.

How is personal data protected?

Requests are authenticated with OAuth2 client credentials and encrypted in transit. Contact us for our security documentation.