List usage record today
Usage records for today
Path parameters
-
The SID of the Account that created the UsageRecord resources to read.
Query parameters
-
Category string
The usage category of the UsageRecord resources to read. Only UsageRecord resources in the specified category are retrieved.
Values are
a2p-registration-fees
,agent-conference
,answering-machine-detection
,authy-authentications
,authy-calls-outbound
,authy-monthly-fees
,authy-phone-intelligence
,authy-phone-verifications
,authy-sms-outbound
,call-progess-events
,calleridlookups
,calls
,calls-client
,calls-globalconference
,calls-inbound
,calls-inbound-local
,calls-inbound-mobile
,calls-inbound-tollfree
,calls-outbound
,calls-pay-verb-transactions
,calls-recordings
,calls-sip
,calls-sip-inbound
,calls-sip-outbound
,calls-transfers
,carrier-lookups
,conversations
,conversations-api-requests
,conversations-conversation-events
,conversations-endpoint-connectivity
,conversations-events
,conversations-participant-events
,conversations-participants
,cps
,flex-usage
,fraud-lookups
,group-rooms
,group-rooms-data-track
,group-rooms-encrypted-media-recorded
,group-rooms-media-downloaded
,group-rooms-media-recorded
,group-rooms-media-routed
,group-rooms-media-stored
,group-rooms-participant-minutes
,group-rooms-recorded-minutes
,imp-v1-usage
,lookups
,marketplace
,marketplace-algorithmia-named-entity-recognition
,marketplace-cadence-transcription
,marketplace-cadence-translation
,marketplace-capio-speech-to-text
,marketplace-convriza-ababa
,marketplace-deepgram-phrase-detector
,marketplace-digital-segment-business-info
,marketplace-facebook-offline-conversions
,marketplace-google-speech-to-text
,marketplace-ibm-watson-message-insights
,marketplace-ibm-watson-message-sentiment
,marketplace-ibm-watson-recording-analysis
,marketplace-ibm-watson-tone-analyzer
,marketplace-icehook-systems-scout
,marketplace-infogroup-dataaxle-bizinfo
,marketplace-keen-io-contact-center-analytics
,marketplace-marchex-cleancall
,marketplace-marchex-sentiment-analysis-for-sms
,marketplace-marketplace-nextcaller-social-id
,marketplace-mobile-commons-opt-out-classifier
,marketplace-nexiwave-voicemail-to-text
,marketplace-nextcaller-advanced-caller-identification
,marketplace-nomorobo-spam-score
,marketplace-payfone-tcpa-compliance
,marketplace-remeeting-automatic-speech-recognition
,marketplace-tcpa-defense-solutions-blacklist-feed
,marketplace-telo-opencnam
,marketplace-truecnam-true-spam
,marketplace-twilio-caller-name-lookup-us
,marketplace-twilio-carrier-information-lookup
,marketplace-voicebase-pci
,marketplace-voicebase-transcription
,marketplace-voicebase-transcription-custom-vocabulary
,marketplace-whitepages-pro-caller-identification
,marketplace-whitepages-pro-phone-intelligence
,marketplace-whitepages-pro-phone-reputation
,marketplace-wolfarm-spoken-results
,marketplace-wolfram-short-answer
,marketplace-ytica-contact-center-reporting-analytics
,mediastorage
,mms
,mms-inbound
,mms-inbound-longcode
,mms-inbound-shortcode
,mms-messages-carrierfees
,mms-outbound
,mms-outbound-longcode
,mms-outbound-shortcode
,monitor-reads
,monitor-storage
,monitor-writes
,notify
,notify-actions-attempts
,notify-channels
,number-format-lookups
,pchat
,pchat-users
,peer-to-peer-rooms-participant-minutes
,pfax
,pfax-minutes
,pfax-minutes-inbound
,pfax-minutes-outbound
,pfax-pages
,phonenumbers
,phonenumbers-cps
,phonenumbers-emergency
,phonenumbers-local
,phonenumbers-mobile
,phonenumbers-setups
,phonenumbers-tollfree
,premiumsupport
,proxy
,proxy-active-sessions
,pstnconnectivity
,pv
,pv-composition-media-downloaded
,pv-composition-media-encrypted
,pv-composition-media-stored
,pv-composition-minutes
,pv-recording-compositions
,pv-room-participants
,pv-room-participants-au1
,pv-room-participants-br1
,pv-room-participants-ie1
,pv-room-participants-jp1
,pv-room-participants-sg1
,pv-room-participants-us1
,pv-room-participants-us2
,pv-rooms
,pv-sip-endpoint-registrations
,recordings
,recordingstorage
,rooms-group-bandwidth
,rooms-group-minutes
,rooms-peer-to-peer-minutes
,shortcodes
,shortcodes-customerowned
,shortcodes-mms-enablement
,shortcodes-mps
,shortcodes-random
,shortcodes-uk
,shortcodes-vanity
,small-group-rooms
,small-group-rooms-data-track
,small-group-rooms-participant-minutes
,sms
,sms-inbound
,sms-inbound-longcode
,sms-inbound-shortcode
,sms-messages-carrierfees
,sms-messages-features
,sms-messages-features-senderid
,sms-outbound
,sms-outbound-content-inspection
,sms-outbound-longcode
,sms-outbound-shortcode
,speech-recognition
,studio-engagements
,sync
,sync-actions
,sync-endpoint-hours
,sync-endpoint-hours-above-daily-cap
,taskrouter-tasks
,totalprice
,transcriptions
,trunking-cps
,trunking-emergency-calls
,trunking-origination
,trunking-origination-local
,trunking-origination-mobile
,trunking-origination-tollfree
,trunking-recordings
,trunking-secure
,trunking-termination
,turnmegabytes
,turnmegabytes-australia
,turnmegabytes-brasil
,turnmegabytes-germany
,turnmegabytes-india
,turnmegabytes-ireland
,turnmegabytes-japan
,turnmegabytes-singapore
,turnmegabytes-useast
,turnmegabytes-uswest
,twilio-interconnect
,verify-push
,verify-totp
,verify-whatsapp-conversations-business-initiated
,video-recordings
,voice-insights
,voice-insights-client-insights-on-demand-minute
,voice-insights-ptsn-insights-on-demand-minute
,voice-insights-sip-interface-insights-on-demand-minute
,voice-insights-sip-trunking-insights-on-demand-minute
,wireless
,wireless-orders
,wireless-orders-artwork
,wireless-orders-bulk
,wireless-orders-esim
,wireless-orders-starter
,wireless-usage
,wireless-usage-commands
,wireless-usage-commands-africa
,wireless-usage-commands-asia
,wireless-usage-commands-centralandsouthamerica
,wireless-usage-commands-europe
,wireless-usage-commands-home
,wireless-usage-commands-northamerica
,wireless-usage-commands-oceania
,wireless-usage-commands-roaming
,wireless-usage-data
,wireless-usage-data-africa
,wireless-usage-data-asia
,wireless-usage-data-centralandsouthamerica
,wireless-usage-data-custom-additionalmb
,wireless-usage-data-custom-first5mb
,wireless-usage-data-domestic-roaming
,wireless-usage-data-europe
,wireless-usage-data-individual-additionalgb
,wireless-usage-data-individual-firstgb
,wireless-usage-data-international-roaming-canada
,wireless-usage-data-international-roaming-india
,wireless-usage-data-international-roaming-mexico
,wireless-usage-data-northamerica
,wireless-usage-data-oceania
,wireless-usage-data-pooled
,wireless-usage-data-pooled-downlink
,wireless-usage-data-pooled-uplink
,wireless-usage-mrc
,wireless-usage-mrc-custom
,wireless-usage-mrc-individual
,wireless-usage-mrc-pooled
,wireless-usage-mrc-suspended
,wireless-usage-sms
, orwireless-usage-voice
. -
StartDate string(date)
Only include usage that has occurred on or after this date. Specify the date in GMT and format as
YYYY-MM-DD
. You can also specify offsets from the current date, such as:-30days
, which will set the start date to be 30 days before the current date. -
EndDate string(date)
Only include usage that occurred on or before this date. Specify the date in GMT and format as
YYYY-MM-DD
. You can also specify offsets from the current date, such as:+30days
, which will set the end date to 30 days from the current date. -
IncludeSubaccounts boolean
Whether to include usage from the master account and all its subaccounts. Can be:
true
(the default) to include usage from the master account and all subaccounts orfalse
to retrieve usage from only the specified account. -
PageSize integer
How many resources to return in each list page. The default is 50, and the maximum is 1000.
Minimum value is
1
, maximum value is1000
.
curl \
-X GET https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Usage/Records/Today.json \
--user "username:password"
{
"end": 42,
"first_page_uri": "https://example.com",
"next_page_uri": "https://example.com",
"page": 42,
"page_size": 42,
"previous_page_uri": "https://example.com",
"start": 42,
"uri": "https://example.com",
"usage_records": [
{
"account_sid": "string",
"api_version": "string",
"as_of": "string",
"category": "a2p-registration-fees",
"count": "string",
"count_unit": "string",
"description": "string",
"end_date": "2023-05-04",
"price": 42.0,
"price_unit": "string",
"start_date": "2023-05-04",
"subresource_uris": {},
"uri": "https://example.com",
"usage": "string",
"usage_unit": "string"
}
]
}
{
"end": 42,
"first_page_uri": "https://example.com",
"next_page_uri": "https://example.com",
"page": 42,
"page_size": 42,
"previous_page_uri": "https://example.com",
"start": 42,
"uri": "https://example.com",
"usage_records": [
{
"account_sid": "string",
"api_version": "string",
"as_of": "string",
"category": "a2p-registration-fees",
"count": "string",
"count_unit": "string",
"description": "string",
"end_date": "2024-05-04",
"price": 42.0,
"price_unit": "string",
"start_date": "2024-05-04",
"subresource_uris": {},
"uri": "https://example.com",
"usage": "string",
"usage_unit": "string"
}
]
}