---
schema_version: "1"
id: f4d91f03b80ff15d9394f9cecf6026f7927951fdbf9784664a415d81dd7b0d43
title: Describe Global
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/platform/api-rest/guides/resources/resources-describeglobal.md
canonical_url: https://developer.salesforce.com/docs/platform/api-rest/guide/resources-describeglobal.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 3ad3dac0d2ce0db7ad1c245ee079090e18677e6de2c803a385ce08b83dc2b883
products:
  - REST API Developer Guide
  - Platform Developer Content
---

# Describe Global

Lists the available objects and the associated metadata. This resource returns both custom and standard objects.

In addition, it provides the org encoding, as well as the maximum batch size permitted in queries. For more information on encoding, see [Internationalization and Character Sets](https://developer.salesforce.com/docs/atlas.en-us.api.meta/api/implementation_considerations.htm#sforce_api_other_internationalization).

You can use the `If-Modified-Since` or `If-Unmodified-Since` header with this resource. If you use the `If-Modified-Since` header and no available object’s metadata has changed since the provided date, a `304 Not Modified` status code is returned with no response body.

**note:** The `If-Modified-Since` and `If-Unmodified-Since` headers check for more than object-specific metadata changes. They also check for org-wide events, such as changes to permissions, profiles, or field labels.

## Syntax

**URI:** `/services/data/vXX.X/sobjects/`

**Formats:** JSON, XML

**HTTP Method:** GET

**Authentication:** `Authorization: Bearer token`

**Parameters**

|Parameter|Description|
|---------|-----------|
|`If-Modified-Since`|An optional header specifying a date and time. The request returns records that have been modified after that date and time. The format is `EEE, dd MMM yyyy HH:mm:ss z`. For example: `If-Modified-Since: Mon, 30 Nov 2020 08:34:54 MST`.|
|`If-Unmodified-Since`|An optional header specifying a date and time. The request returns records that haven’t been modified after that date and time. The format is `EEE, dd MMM yyyy HH:mm:ss z`. For example: `If-Unmodified-Since: Mon, 30 Nov 2020 08:34:54 MST`.|

## Example

See [Get a List of Objects](https://developer.salesforce.com/docs/platform/api-rest/do-me/dome-describeglobal.md).

**See Also**  


-   [Conditional Request Headers](https://developer.salesforce.com/docs/platform/api-rest/intro/intro-rest-conditional-requests.md)