Create a customer callout | Aura Panic API

curl -X POST https://staging-panic.aura.services/panic-api/v2/customers/12345/callouts \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "location": {
    "latitude": -26.10911,
    "longitude": 28.053037,
    "accuracy": 10
  },
  "responseTypeId": 1,
  "calloutClassificationId": 2,
  "internalTest": false
}'

{
  "message": "string",
  "callout": {
    "id": 12345,
    "status": "created",
    "cancelledByCustomer": true,
    "verified": true,
    "verifiedBy": "string",
    "verifiedAt": "2024-01-15T09:30:00Z",
    "resolvedAt": "2024-01-15T09:30:00Z",
    "loggedAt": "2024-01-15T09:30:00Z",
    "createdAt": "2024-01-15T09:30:00Z",
    "updatedAt": "2024-01-15T09:30:00Z",
    "source": "API",
    "dispatchRequired": true,
    "acknowledged": true,
    "owned": true,
    "messageId": "string",
    "responseTypeId": 1,
    "calloutClassificationId": 2,
    "calloutLocationTypeId": 1,
    "internalTest": true,
    "parentCalloutId": 1,
    "regionId": 1,
    "inCoverage": true,
    "escalated": true,
    "routedControlCentre": true,
    "externalRefId": "string",
    "customerSourceId": 249,
    "customerId": 12345,
    "url": "string",
    "metaData": {},
    "integrationUserId": 1,
    "ownedByUserId": 1,
    "requestedByCustomerId": 1,
    "rejectedByCustomerId": 1,
    "lastUpdatedBy": "string",
    "lastUpdatedByClientId": "string",
    "firstAcknowledgedBy": "string",
    "firstAcknowledgedAt": "2024-01-15T09:30:00Z",
    "ownedBy": "string",
    "ownedAt": "2024-01-15T09:30:00Z",
    "escalatedAt": "2024-01-15T09:30:00Z",
    "escalatedBy": "string",
    "location": {
      "latitude": "-26.10911",
      "longitude": "28.053037",
      "accuracy": 10,
      "calloutId": 1,
      "predefinedLocationId": 1,
      "formattedAddress": "string"
    },
    "calloutResponderInRanges": [
      {}
    ],
    "customer": {
      "name": "Fogell",
      "surname": "McLovin",
      "mobile": "+27847493388",
      "email": "string",
      "gender": "string",
      "dateOfBirth": "2024-01-15T09:30:00Z",
      "businessName": "string",
      "duressCode": "string",
      "externalReferenceId": "string",
      "vehicleMake": "string",
      "vehicleModel": "string",
      "vehicleColour": "string",
      "vehicleLicensePlate": "string",
      "hasMedicalAid": true,
      "medicalConditions": "string",
      "medications": "string",
      "allergies": "string",
      "medicalAidNumber": "string",
      "medicalAidScheme": "string",
      "nextOfKinName": "string",
      "nextOfKinNumber": "string",
      "bloodType": "string",
      "familyDoctorPhoneNumber": "string",
      "medicalOther": "string",
      "id": 12345,
      "customerSourceId": 12,
      "auth0UserId": "string",
      "createdAt": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:30:00Z",
      "imageId": 1,
      "customerTypeId": 1,
      "referredByCodeId": 1,
      "referredByCustomerId": 1,
      "stripeCustomerId": "string",
      "medicalAidPlan": "string",
      "hasVehicle": true,
      "referralCode": "string",
      "hasPanicked": true,
      "subscriptions": [
        {
          "id": 12345,
          "customerId": 12345,
          "subscriptionTypeId": 4,
          "validFrom": "2024-01-15T09:30:00Z",
          "validTo": "2024-01-15T09:30:00Z",
          "CancelledDate": "2024-01-15T09:30:00Z",
          "CancelledReason": "string",
          "subscriptionToken": "string",
          "dependantCustomerIds": [
            1
          ],
          "membersFullName": "OpenAPI Sub",
          "relationship": "MAIN",
          "numberOfAddedDependents": "0",
          "subscriptionType": {
            "id": 2,
            "description": "API single subscription",
            "value": "API_SINGLE",
            "numberOfAllowedDependents": "4",
            "recurringBilling": false,
            "period": "string",
            "name": "string",
            "createdAt": "2024-01-15T09:30:00Z",
            "updatedAt": "2024-01-15T09:30:00Z"
          }
        }
      ]
    },
    "customerSource": {
      "id": 249,
      "description": "AURA Integration Test",
      "partnerId": 1,
      "supplierId": 1,
      "verificationRequired": true,
      "createdAt": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:30:00Z"
    },
    "calloutincidentdetail": {
      "id": 1,
      "responderId": 1,
      "responderDispatched": true,
      "supplierIdBeforeCancellation": 1,
      "supplierId": 1
    },
    "requestedByCustomer": {
      "id": 1,
      "mobile": "string",
      "name": "string",
      "surname": "string",
      "email": "string"
    }
  }
}

Preferred callout creation endpoint. The customer must have an active subscription. Provide either live coordinates or a fixed location (predefinedLocationId) depending on the integration model.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

customerIdintegerRequired

Customer identifier.

Request

This endpoint expects an object.

locationobjectRequired

responseTypeIdintegerRequired

calloutClassificationIdintegerOptional

internalTestbooleanOptional

Legacy flag that routes the callout to a specific test supplier attached to your customer source. Not used by modern integrations — omit it and test with the staging Responder Simulator instead.

Response

Successful.

messagestring

calloutobject

Errors

400

Bad Request Error

401

Unauthorized Error