# Request Location

## Request a contact's location

**post** `/api/request-location`

Send a Find My location request to an iMessage recipient from a supported Sendblue line. The request is queued like a normal outbound iMessage. If the recipient accepts and shares, the location is delivered later as an inbound `message_type: location` webhook.

### Body Parameters

- `from_number: string`

  Your supported Sendblue number in E.164 format

- `number: string`

  Recipient phone number in E.164 format

### Returns

- `message: optional string`

- `message_handle: optional string`

  Unique identifier for tracking the request message

- `number: optional string`

  Recipient phone number

- `status: optional "QUEUED"`

  - `"QUEUED"`

- `uuid: optional string`

  Unique identifier for tracking the request message

### Example

```http
curl https://api.sendblue.co/api/request-location \
    -H 'Content-Type: application/json' \
    -H "sb-api-key-id: $SENDBLUE_API_API_KEY" \
    -H "sb-api-secret-key: $SENDBLUE_API_API_SECRET" \
    -d '{
          "from_number": "+18887776666",
          "number": "+19998887777"
        }'
```

#### Response

```json
{
  "message": "Location request accepted for dispatch",
  "message_handle": "msg_abc123def456",
  "number": "+19998887777",
  "status": "QUEUED",
  "uuid": "msg_abc123def456"
}
```

## Domain Types

### Request Location Create Response

- `RequestLocationCreateResponse object { message, message_handle, number, 2 more }`

  - `message: optional string`

  - `message_handle: optional string`

    Unique identifier for tracking the request message

  - `number: optional string`

    Recipient phone number

  - `status: optional "QUEUED"`

    - `"QUEUED"`

  - `uuid: optional string`

    Unique identifier for tracking the request message