> ## Documentation Index
> Fetch the complete documentation index at: https://docs.populardemand.market/llms.txt
> Use this file to discover all available pages before exploring further.

# get_request

> Get a Request

Read one Request: what the person asked for, its items and options, open questions, notification settings and a summary of any Offers.

## Access

| Property | Value |
| - | - |
| OAuth scope | `purchases:read` |
| Effect | `none` |
| `readOnlyHint` | Yes |
| `destructiveHint` | No |
| `idempotentHint` | Yes |
| `openWorldHint` | No |

The buyer also approves each permission on the consent page. See [Authentication](https://docs.populardemand.market/authentication.md).

## Arguments

| Field | Type | Required | Description |
| - | - | - | - |
| `request_id` | string (uuid) | Yes | The Request’s id from list\_requests. |
| `detail` | `summary`, `full` | No | summary (the default) or full, the whole Request with its history. Default `"summary"`. |

> [accordion] Input JSON Schema
>
> ```json theme={null}
> {
>   "type": "object",
>   "properties": {
>     "request_id": {
>       "type": "string",
>       "format": "uuid",
>       "description": "The Request’s id from list_requests."
>     },
>     "detail": {
>       "default": "summary",
>       "description": "summary (the default) or full, the whole Request with its history.",
>       "type": "string",
>       "enum": [
>         "summary",
>         "full"
>       ]
>     }
>   },
>   "required": [
>     "request_id"
>   ],
>   "additionalProperties": false
> }
> ```

> [accordion] Output JSON Schema
>
> ```json theme={null}
> {
>   "type": "object",
>   "properties": {
>     "result": {
>       "type": "object",
>       "properties": {
>         "request_id": {
>           "type": "string"
>         },
>         "version": {
>           "type": "integer",
>           "minimum": -9007199254740991,
>           "maximum": 9007199254740991
>         },
>         "status": {
>           "type": "string",
>           "enum": [
>             "open",
>             "closed"
>           ]
>         },
>         "status_label": {
>           "type": [
>             "string",
>             "null"
>           ]
>         },
>         "words": {
>           "type": "string"
>         },
>         "country": {
>           "type": "string"
>         },
>         "currency": {
>           "type": "string"
>         },
>         "destination": {},
>         "need_by": {},
>         "time_horizon": {
>           "type": [
>             "string",
>             "null"
>           ]
>         },
>         "delivery": {
>           "type": "array"
>         },
>         "all_items_required": {
>           "type": [
>             "boolean",
>             "null"
>           ]
>         },
>         "items": {
>           "type": "array"
>         },
>         "price_limits": {
>           "type": "array"
>         },
>         "expires_at": {
>           "type": "string"
>         },
>         "next_step": {
>           "type": [
>             "string",
>             "null"
>           ]
>         },
>         "needs_attention": {
>           "type": "array"
>         },
>         "open_questions": {
>           "type": "array"
>         },
>         "notifications": {
>           "type": "object",
>           "additionalProperties": true
>         },
>         "offers": {
>           "type": "array"
>         },
>         "status_message": {
>           "type": [
>             "string",
>             "null"
>           ]
>         },
>         "full": {
>           "type": "object",
>           "additionalProperties": true
>         }
>       },
>       "required": [
>         "request_id",
>         "version",
>         "status",
>         "status_label",
>         "words",
>         "country",
>         "currency",
>         "destination",
>         "need_by",
>         "time_horizon",
>         "delivery",
>         "all_items_required",
>         "items",
>         "price_limits",
>         "expires_at",
>         "next_step",
>         "needs_attention",
>         "open_questions",
>         "notifications",
>         "offers",
>         "status_message"
>       ],
>       "additionalProperties": false
>     }
>   },
>   "required": [
>     "result"
>   ],
>   "additionalProperties": false
> }
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.