Create Policy

1 import requests 2 3 url = "https://app.usebridge.com/api/policies/v2" 4 5 payload = { 6 "person": { 7 "firstName": "firstName", 8 "lastName": "lastName", 9 "dateOfBirth": "2024-01-15T09:30:00Z" 10 }, 11 "state": "AL", 12 "payerId": "payerId" 13 } 14 headers = { 15 "X-API-Key": "<apiKey>", 16 "Content-Type": "application/json" 17 } 18 19 response = requests.post(url, json=payload, headers=headers) 20 21 print(response.json())

1 { 2 "id": "id", 3 "payerId": "payerId", 4 "payer": { 5 "id": "id", 6 "code": "code", 7 "name": "name", 8 "memberId": true, 9 "hint": "hint" 10 }, 11 "status": "PENDING", 12 "state": "AL", 13 "_token": "_token", 14 "planName": "planName", 15 "person": { 16 "firstName": "firstName", 17 "lastName": "lastName", 18 "middleName": "middleName", 19 "dateOfBirth": "2024-01-15T09:30:00Z" 20 }, 21 "errors": [ 22 { 23 "code": "code", 24 "message": "message" 25 }, 26 { 27 "code": "code", 28 "message": "message" 29 } 30 ], 31 "memberId": "memberId", 32 "policyHolder": { 33 "firstName": "firstName", 34 "lastName": "lastName", 35 "middleName": "middleName", 36 "dateOfBirth": "2024-01-15T09:30:00Z" 37 }, 38 "relationship": "SELF", 39 "patientId": "patientId", 40 "latest": { 41 "id": "id", 42 "plan": "plan", 43 "validatedAt": "2024-01-15T09:30:00Z", 44 "effectiveFrom": "2024-01-15T09:30:00Z", 45 "effectiveTo": "2024-01-15T09:30:00Z" 46 } 47 }

Creates a Policy, returning immediately with status of PENDING. Use the Get Policy API, or monitor webhooks, to receive updates.

Authentication

X-API-Keystring

API Key authentication via header

Request

This endpoint expects an object.

personobjectRequired

stateenumRequired

2 letter US state code

payerIdstringRequired

memberIdstringOptional

dateOfServicedatetimeOptional

Full ISO8601 timestamp, including timezone

Response

This endpoint returns an object.

idstring

payerIdstring

payerobject

statusenum

Allowed values:

stateenum

2 letter US state code

_tokenstring

Temporary access token to retrieve this Policy

planNamestring or null

personobject or null

errorslist of objects or null

memberIdstring or null

policyHolderobject or null

relationshipenum or null

Allowed values:

patientIdstring or null

latestobject or null