Newer Version Available

This content describes an older version of this product. View Latest

Limit Info Header

This response header is returned in each request to the REST API. You can use the information to monitor API limits.

Header Field Name and Values

Field name
Sforce-Limit-Info
Field values
  • api-usage—Specifies the API usage for the organization against which the call was made in the format nn/nnnn. The first number is the number of API calls used, and the second number is the API limit for the organization.
  • per-app-api-usage—Specifies the limit quota information for the currently connected app. API limit app quotas are currently available through a pilot program. For information on enabling this feature for your organization, contact Salesforce. This example includes the limit quota for a sample-connected-app connected app. If there is no limit quota information, this field isn’t returned.
    1Sforce-Limit-Info: api-usage=25/5000; per-app-api-usage=17/250(appName=sample-connected-app)
Example
Response to a REST request for a Merchandise record, including the limit information in line three:
1HTTP/1.1 200 OK
2Date: Mon, 20 May 2013 22:21:46 GMT
3Sforce-Limit-Info: api-usage=18/5000
4Last-Modified: Mon, 20 May 2013 20:49:32 GMT
5Content-Type: application/json;charset=UTF-8
6Transfer-Encoding: chunked
7
8{
9  "attributes" : {
10    "type" : "Merchandise__c",
11    "url" : "/services/data/v37.0/sobjects/Merchandise__c/a00D0000008pQSNIA2"
12  },
13  "Id" : "a00D0000008pQSNIA2",
14  "OwnerId" : "005D0000001QX8WIAW",
15  "IsDeleted" : false,
16  "Name" : "Phone Case - iPhone 4/4S",
17  "CreatedDate" : "2013-05-20T20:49:32.000+0000",
18  "CreatedById" : "005D0000001QX8WIAW",
19  "LastModifiedDate" : "2013-05-20T20:49:32.000+0000",
20  "LastModifiedById" : "005D0000001QX8WIAW",
21  "SystemModstamp" : "2013-05-20T20:49:32.000+0000",
22  "LastActivityDate" : null,
23  "LastViewedDate" : "2013-05-20T22:19:56.000+0000",
24  "LastReferencedDate" : "2013-05-20T22:19:56.000+0000",
25  "Description__c" : "Phone Case for iPhone 4/4S",
26  "Price__c" : 16.99,
27  "Stock_Price__c" : 12.99,
28  "Total_Inventory__c" : 108.0
29}