# Questions

### Get questions <a href="#get-questions" id="get-questions"></a>

Retrieve the suggested questions configured for your clone. These are the conversation starters shown on your clone's profile.

**Endpoint:** `GET /v3/questions`

**Query parameters:**

| Parameter   | Type    | Required | Default    | Description                            |
| ----------- | ------- | -------- | ---------- | -------------------------------------- |
| `type`      | string  | No       | `"pinned"` | Filter: `pinned`, `unpinned`, or `all` |
| `count`     | integer | No       | `5`        | Number of questions to return (1–100)  |
| `randomize` | boolean | No       | `false`    | Return questions in random order       |

**Type values:**

| Value      | Description                             |
| ---------- | --------------------------------------- |
| `pinned`   | Visible questions shown on your profile |
| `unpinned` | Backlog questions not currently visible |
| `all`      | Both pinned and unpinned questions      |

**Example request:**

```bash
curl "https://api.delphi.ai/v3/questions?type=pinned&count=3" \
  -H "x-api-key: YOUR_API_KEY"
```

**Example response:**

```json
{
  "questions": [
    {
      "id": "q-001",
      "index": 2,
      "question": "What's your best advice for beginners?",
      "pinned": true,
      "user_edited": false,
      "created_at": "2025-06-01T12:00:00.000Z",
      "updated_at": "2025-06-01T12:00:00.000Z"
    },
    {
      "id": "q-002",
      "index": 1,
      "question": "How did you get started in your career?",
      "pinned": true,
      "user_edited": true,
      "created_at": "2025-05-20T09:00:00.000Z",
      "updated_at": "2025-06-10T14:30:00.000Z"
    }
  ]
}
```

**Response fields:**

| Field         | Type    | Description                                    |
| ------------- | ------- | ---------------------------------------------- |
| `id`          | string  | Question UUID                                  |
| `index`       | integer | Display order index                            |
| `question`    | string  | The question text                              |
| `pinned`      | boolean | Whether the question is visible on the profile |
| `user_edited` | boolean | Whether the question was manually edited       |
| `created_at`  | string  | ISO 8601 timestamp                             |
| `updated_at`  | string  | ISO 8601 timestamp                             |

{% hint style="info" %}
By default, questions are ordered by `index` descending. Use `randomize=true` to shuffle the order.
{% endhint %}