---
title: Access data objects using the REST API
description: IDM provides access to data objects through the Advanced Identity Cloud REST API. To access objects over REST, you can use a browser-based REST client, such as the Simple REST Client for Chrome or RESTClient for Firefox. Alternatively, you can use the curl command-line utility.
component: pingoneaic
page_id: pingoneaic:idm-objects:data-rest
canonical_url: https://docs.pingidentity.com/pingoneaic/idm-objects/data-rest.html
keywords: ["Data Object Model", "REST API"]
---

# Access data objects using the REST API

IDM provides access to data objects through the Advanced Identity Cloud REST API. To access objects over REST, you can use a browser-based REST client, such as the *Simple REST Client* for Chrome or *RESTClient* for Firefox. Alternatively, you can use the [curl](https://curl.se/) command-line utility.

Refer to the [REST API](../idm-rest-api/preface.html) for a comprehensive overview.

To obtain a managed object through the REST API, perform an HTTP GET on the corresponding URL; for example:

```
https://<tenant-env-fqdn>/openidm/managed/realm-name_organization/mysampleorg
```

|   |                                                                                                                          |
| - | ------------------------------------------------------------------------------------------------------------------------ |
|   | Performing an HTTP GET on the corresponding URL is dependent on your security settings and authentication configuration. |

By default, the HTTP GET returns a JSON representation of the object.

In general, you can map any HTTP request to the corresponding `openidm.method` call. For more information, refer to [script functions](../idm-scripting/scripting-func-engine.html).

The following example shows how the parameters provided in an `openidm.query` request correspond with the key-value pairs you would include in a similar HTTP GET request. It shows the same call using the Resource API and the REST API:

* Resource API

* REST API

Reading an object using the Resource API:

```javascript
openidm.query("managed/realm-name_user", { "_queryFilter": "true" }, ["userName","sn"])
```

Reading an object using the REST API:

```
curl \
--header "Authorization: Bearer <access-token>" \
--header "Accept-API-Version: resource=1.0" \
--request GET \
"https://<tenant-env-fqdn>/openidm/managed/realm-name_user?_queryFilter=true&_fields=userName,sn"
```