---
title: Read
description: To retrieve a single resource, perform an HTTP GET on the resource by its case-sensitive identifier (_id) and accept a JSON response:
component: pingoneaic-api
page_id: pingoneaic-api::crest/read
canonical_url: https://developer.pingidentity.com/pingoneaic-api/crest/read.html
section_ids:
  parameters: Parameters
---

# Read

To retrieve a single resource, perform an HTTP GET on the resource by its case-sensitive identifier (`_id`) and accept a JSON response:

```http
GET /users/some-id HTTP/1.1
Host: example.com
Accept: application/json
```

## Parameters

You can use the following query string parameters:

| Parameter                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `_fields=field[,field...]` | Return only the specified fields in the body of the response.The `field` values are JSON pointers. For example, if the resource is `{"parent":{"child":"value"}}`, `parent/child` refers to the `"child":"value"`.If the `field` is left blank, the endpoint returns all default values.                                                                                                                                                                                 |
| `_mimeType=mime-type`      | Some resources have fields containing multimedia resources, such as a profile photo.If the feature is enabled for the endpoint, read a single multimedia resource field by specifying the field and mime-type.The content type of the field value returned matches the mime-type. The body of the response is the multimedia resourceDo not use the `Accept` header. For example, `Accept: image/png` does not work. Use the `_mimeType` query string parameter instead. |
| `_prettyPrint=true`        | Format the body of the response.                                                                                                                                                                                                                                                                                                                                                                                                                                         |