Pre-authorization Requests

List PA Requests

Get list of Pre-authorization requests for Insurer or hospital

get/v1/pa-requests

Request

  • Base URL: https://api.health.curacel.co/api
  • URL: https://api.health.curacel.co/api/v1/pa-requests
  • Auth: HTTP bearer

Query parameters

status'approved' | 'pending' | 'rejected' | 'partially_approved'

The status of the PA requests.

Note: 'partially_approved' points to PA Requests that have been approved but whose approved amount is less than the total amount.

enrollee_idinteger

The ID of the enrollee the PA requests were created for

insurance_nostring

The insurance number of the enrollee the PA requests were created for. This is only considered when no value is provided for enrollee_id

provider_idinteger

Applicable if fetching list as an Insurer

The ID of the hospital that created the PA requests

insurer_idinteger

Applicable if fetching list as a provider/hospital

The ID of the Insurer that owns the created PA requests

searchstring

This is used to search for claims by the key word supplied to it.

The search is applied to the enrollee firstname, lastname, and insurance number, the PA codes, as well as diagnoses icd codes and names.

is_handledboolean

This parameter is used to filter the PA Requests based on if an action has been performed on it.

is_closedboolean

This parameter is used to filter the PA Requests based on if it has been either approved or rejected as the final action.

is_syncedboolean

This parameter is used to filter the PA Requests based on if they have been synced with external db or not.

OR
string date

Filter returned PA Requests by the creation date.

This implements a range filtering on the PA Requests when set to an object with keys of 'start' and 'end' bearing date values. Setting it to a single date string also filters the PA Requests with a direct comparison to the value given.

OR
string date

Filter returned PA Requests by the handled date.

This implements a range filtering on the PA Requests when set to an object with keys of 'start' and 'end' bearing date values. Setting it to a single date string also filters the PA Requests with a direct comparison to the value given.

OR
string date

Filter returned PA Requests by the closed date or date by which is was either approved or rejected.

This implements a range filtering on the PA Requests when set to an object with keys of 'start' and 'end' bearing date values. Setting it to a single date string also filters the PA Requests with a direct comparison to the value given.

OR
string date

Filter returned PA Requests by the synced date if available.

This implements a range filtering on the PA Requests when set to an object with keys of 'start' and 'end' bearing date values. Setting it to a single date string also filters the PA Requests with a direct comparison to the value given.

for_exportboolean

Used to fetch an exported list of PA requests in Excel format. Can be used in conjunction with other filters to achieve results.

pageinteger

The presence of this param would return results in paginated format Better used together with the 'per_page' param

This is used to indicate the offset from which results are fetched in paginated format.

per_pageinteger

Better used together with the 'page' param

This is used to indicate the how many results are to be in an offset for pagination.

withstring

Optional comma-separated relations to include in each PA record.

Supported values include cares, items, and nested item relations like items.tariffItem. Benefit summaries on cares[] and items[] are returned when those relations are included.

Response

Success

pageinteger
per_pageinteger
totalinteger

Changes

No recorded changes to this operation across all 1 revision of this API.