API Total Usage

API Total usage events contain details about Platform SOAP API, Platform REST API, and Bulk API requests.

For details about event monitoring, see the Trailhead Event Monitoring module or REST API Developer’s Guide.

  • Type: String

  • Description: The category of the client making the API request.

  • Possible values:

    • AGENTFORCE_AGENT - API request is from an Agentforce agent.
    • EXTERNAL_APPLICATION - API request is from an external app defined in the org.
    • LIGHTNING_UI - API request is from the Lightning UI.
    • SALESFORCE - API request is from an internal Salesforce app or service.
    • UNKNOWN - API request is from an unrecognized category.
    • SALESFORCE_HOSTED_MCP - API request is from a Salesforce Hosted MCP Server.
  • Type: String
  • Description: The API family. Possible values are REST, SOAP, Bulk, ApexREST, DirectApexREST or DirectAura. ApexREST indicates an Apex REST call. DirectApexREST indicates an Apex REST Agent Action call. DirectAura indicates an AuraEnabled Apex Agent Action call.
  • Type: String
  • Description: The API method or resource. For example, describeSObjects for SOAP, or /v21.0/sobjects/Account/001xx000003DGQW for REST.
  • Type: Number
  • Description: The API version.
  • Example: 21.0
  • Type: String
  • Description: The IP address of the client that’s using Salesforce services. A Salesforce internal IP (such as a login from AppExchange) is shown as “Salesforce.com IP”.
  • Example: 96.43.144.26
  • Type: String
  • Description: The name of the client making the API request. Includes values passed via the Sforce-Call-Options header.
  • Type: String
  • Description: The ID of the connected app making the API request. If the connected app ID includes the prefix 0H4, append it to the connected app ID in the My Domain URL to access app details (https://MyDomainName.my.salesforce.com/0H4xxxxxxxxxxxx). If, however, the connected app ID uses the prefix 888, contact Salesforce Customer Support for app details.
  • Type: String
  • Description: The name of the connected app making the API request.
  • Type: Boolean
  • Description: Whether the request counted against the API limit (true) or not (false).
  • Type: Set
  • Description: The name of the object accessed by the API request.
  • Examples: Account, Opportunity, Contact, and so on.
  • Type: String
  • Description: The type of event. The value is always ApiTotalUsage.
  • Type: String
  • Description: The HTTP method.
  • Example: GET
  • Type: Id
  • Description: The 15-character ID of the organization.
  • Example: 00D000000000123
  • Type: String
  • Description: The unique ID of a single transaction. A transaction can contain one or more events. Each event in a given transaction has the same REQUEST_ID.
  • Example: 3nWgxWbDKWWDIk0FKfF5DV
  • Type: Number
  • Description: The HTTP response status code for the request.
  • Type: String
  • Description: The access time of Salesforce services in GMT.
  • Example: 20130715233322.670
  • Type: DateTime
  • Description: The access time of Salesforce services in ISO8601-compatible format (YYYY-MM-DDTHH:MM:SS.sssZ). The timezone is GMT.
  • Example: 2015-07-27T11:32:59.555Z
  • Type: Id
  • Description: The 15-character ID of the user who’s using Salesforce services through the API.
  • Example: 00530000009M943
  • Type: String
  • Description: The username of the user who’s using Salesforce services through the API.