Limit Info Header

Header Field Name and Values

The Limit Info header is a response header that’s returned from each call to the REST API. This header returns limit information for the organization. Use this header to monitor your API limits as you make calls against the organization.

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, if there is any, 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.
  1Sforce-Limit-Info: api-usage=25/5000; per-app-api-usage=17/250(appName=sample-connected-app)

Example

Sforce-Limit-Info: api-usage=14/5000

This is an example of a response to a REST request for a Merchandise record.

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/v32.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}