# Partner / Third-party APIs

Revised 02/18/2019

# Setup

Base URL

• https://api.aclaimant.com/partner

Authorization

• Aclaimant will provide you with a bearer token, to be used in the Authorization header:

  Authorization: Bearer <bearer-token>

# Endpoints

# Claim Receipt

POST /claims/<claim-id>/receipt

URL Parameters

• claim-id → Aclaimant's unique identifier from the API submission to the partner

Request Parameters

• claim-number → The number associated with this claim in the partner's system.
  • Type: String
  • Required?: true
  • Validations: must be unique for the policy within Aclaimant
• receipt-status → The partner's status of the claim
  • Type: String
    • pending, accepted or denied
  • Required?: true
• receipt-status-date → The date and time which the partner's system made the change in status
  • Type: date-time
  • Required?: true

Responses

Success: 204

---

# Claim Updates with Loss Runs

PUT /claims/<claim-id>

URL Parameters

• claim-id → Aclaimant's unique identifier from the API submission to the partner

Request Parameters

• status → The current status of the claim
  • Type: String
    • open or closed
• closed-date → The date the claim was closed
  • Type: date-time
  • Required?: true/false
    • Policies in Aclaimant determine if a close date is required, so this is dependent on the setup of the associated policy.
• new-report → The latest claim financials report for this claim
  • Type: claim-report
  • Required?: false

Response

Success: 204

# Data Types

date-time

• Format: ISO format “YYYY-MM-DDTHH:mm:SSz”
  • 2019-02-07T21:12:49.935-00:00

claim-report

• date-of-report → The date the report was created
  • Type: date-time
  • Required?: true
• adjuster → The adjuster on this report
  • Type: String
  • Required?: false
    • If adjuster is not provided, the previous report's adjuster will be used if available.
• adjuster-notes → Any notes that the adjuster has left on this claim
  • Type: String
  • Required?: false
• target-close-date → The date the adjuster thinks this claim will close
  • Type: date-time
  • Required?: false
• entries[]
  • Type: Array of entry
  • Required?: true
  • Validations:
    • length ≥ 1

entry

• category → The category of this report entry.
  • Type: String
    • medical indemnity expense legal vocational recovery general property-damage cargo-loss or cargo-damage
  • Required?: true
• payment-amount
  • Type: Number
  • Required?: true
  • Validations:
    • Positive
    • 2 decimals places
• reserve-amount
  • Type: Number
  • Required?: true
  • Validations:
    • Positive
    • 2 decimals places

# Errors

• 400 → Bad Request — Your request is invalid.
• 401 → Unauthorized — Your API key is wrong.
• 404 → Not Found — The specified resource could not be found.
• 429 → Too Many Requests — You're requesting too frequently. Slow down.
• 500 → Internal Server Error — We had a problem with our servers. Try again later.
• 503 → Service Unavailable — We are temporarily offline. Please try again later.