AXaxa-assistance

Create a medical assistance incident linked to a travel claim.

Changed on

Create a medical assistance incident linked to a travel claim.

N.B. This endpoint can only be used when the claims request_type is equal to ASSISTANCE.

post/insurance/travel/v2/claims/{claim_id}/medical_assistance_incidents

Request

  • Base URL
    https://sandbox.api.axapartners.com
  • URL
    https://sandbox.api.axapartners.com/insurance/travel/v2/claims/{claim_id}/medical_assistance_incidents
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://sandbox.auth.api.axapartners.com/oauth/token scopes: urn:axa.partners.insurance.travel.claims.write

Path parameters

claim_idstring required

Claim identifier.

Example:e941c951-6101-41b8-b227-28c0495227f3

Headers

x-environment'test' | 'preprod' | 'prod'

When calling the API, the client can precise in which environment the information should be sent. The environments are listed below:

  • test --> UAT / User Acceptance Environment.
  • preprod --> Pre-production (real data, real clients to validate the software before release to production).
  • prod --> Production environment.
x-tenant-idstring
Example:42bbd332fa8f48e7bb382165f257a579

The unique identifier of the tenant, the value should be provided by AXA.

Request body

planned_trip_idstring required

Identifier of the planned trip where the incident occurred.

emergency_assistance_type'MEDICAL_ASSISTANCE_NOT_USING_LOCAL_EMERGENCY_NUMBER' | 'MEDICAL_ASSISTANCE_USING_LOCAL_EMERGENCY_NUMBER' | 'NON_URGENT_MEDICAL_ASSISTANCE'

Type of assistance which insured is requesting for.

  • MEDICAL_ASSISTANCE_NOT_USING_LOCAL_EMERGENCY_NUMBER: Medical Assistance not using Local Emergency Number. The end customer cannot find the country's local emergency phone number and needs AXA's help to arrange medical evacuation. (e.g. is in a remote location in Africa) An emergency assistance case is registered and AXA Partners agent will contact the end customer to provide assistance.

  • MEDICAL_ASSISTANCE_USING_LOCAL_EMERGENCY_NUMBER: Medical Assistance using local emergency phone number. The end customer seeks medical assistance using the country specific emergency number, (e.g. 911 in the USA).

  • NON_URGENT_MEDICAL_ASSISTANCE: Non emergency assistance

Example request

{
  "planned_trip_id": "1db7a370-3cf3-4427-8526-fac2af885c9c",
  "provider": {
    "provider_id": "38d07441b8804e6e81b39e25b32a0a0c"
  },
  "emergency_assistance_type": "MEDICAL_ASSISTANCE_USING_LOCAL_EMERGENCY_NUMBER",
  "circumstance": {
    "type": "INJURY",
    "description": "Broken legs",
    "medical_condition": {
      "started_at": "2019-03-02T10:59:00.0000000+00:00",
      "description": "Broken legs"
    },
    "affected_person": {
      "involved_person_id": "bb2df1d1-85b2-472f-b391-cce0062ea5bb",
      "was_inpatient": true,
      "inpatient_information": {
        "admitted_at": "2019-06-11T10:55:30.0000000+00:00"
      }
    }
  },
  "attachments": [
    {
      "attachment_id": "7f88b079-2205-4335-b72e-72d994e47fc8",
      "name": "car_rental_invoice.jpg",
      "attachment_category": "POLICE_REPORT"
    }
  ],
  "questions_and_answers": [
    {
      "question_id": "6c8bd730-fef8-4ebf-9baf-f2d2883b91f2",
      "question_text": "What is the age of the oldest passenger?",
      "enumeration_answers": [
        {
          "answer_text": "Between 50 and 70",
          "answer_id": "3252e3cc-2862-4772-8176-5b6f2b70e048"
        }
      ],
      "answered_text": "The age of the oldest passager is sixty-nine.",
      "answered_amount": {
        "value": 199.99,
        "currency": "EUR"
      },
      "answered_distance": {
        "value": 30,
        "unit": "km"
      },
      "answered_weight": {
        "value": 1250,
        "unit": "kg"
      }
    }
  ]
}

Response

Medical assistance incident created.

incident_idstring

Identifier of the incident.

planned_trip_idstring

Identifier of the planned trip where the incident occurred.

Example response

{
  "incident_id": "ec2ebd7f-684c-4d52-9a5f-fc49a23bc89c",
  "planned_trip_id": "1db7a370-3cf3-4427-8526-fac2af885c9c",
  "circumstance": {
    "type": "INJURY",
    "description": "Broken legs",
    "medical_condition": {
      "started_at": "2019-03-02T10:59:00.0000000+00:00",
      "description": "Broken legs"
    },
    "affected_person": {
      "involved_person_id": "bb2df1d1-85b2-472f-b391-cce0062ea5bb",
      "was_inpatient": true,
      "inpatient_information": {
        "admitted_at": "2019-06-11T10:55:30.0000000+00:00"
      }
    }
  },
  "provider": {
    "provider_id": "38d07441b8804e6e81b39e25b32a0a0c"
  },
  "attachments": [
    {
      "attachment_id": "7f88b079-2205-4335-b72e-72d994e47fc8",
      "name": "car_rental_invoice.jpg",
      "attachment_category": "POLICE_REPORT"
    }
  ],
  "questions_and_answers": [
    {
      "question_id": "6c8bd730-fef8-4ebf-9baf-f2d2883b91f2",
      "question_text": "What is the age of the oldest passenger?",
      "enumeration_answers": [
        {
          "answer_text": "Between 50 and 70",
          "answer_id": "3252e3cc-2862-4772-8176-5b6f2b70e048"
        }
      ],
      "answered_text": "The age of the oldest passager is sixty-nine.",
      "answered_amount": {
        "value": 199.99,
        "currency": "EUR"
      },
      "answered_distance": {
        "value": 30,
        "unit": "km"
      },
      "answered_weight": {
        "value": 1250,
        "unit": "kg"
      }
    }
  ]
}

Changes

  • df05aef69b3fRevision changes
    • breaking

      added the new required request property /

    • breaking

      added the new required request property /

    • breaking

      the request property type changed from no type to object

    • breaking

      the // response's property type changed from no type to object for status

    • breaking

      the // response's property type changed from no type to object for status

    • warning

      removed subschema #1 from the request property allOf list

    • info

      added the new optional request property /

    • info

      added the new required request property / with a default value

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      removed subschema #1 from the // response property allOf list for the response status

    • info

      removed subschema #1 from the // response property allOf list for the response status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

  • efe32b811f1dRevision changes
    • info

      endpoint added