Reports API

Retrieve call logs for your account.

Retrieve call logs for your account

Retrieve call logs for your account

GET https://api.vonage.com/t/vbc.prod/reports/accounts/:account_id/call-logs

Authentication

Key Description Example Default
Authorization Your OAuth token.
Read more about OAuth tokens
Bearer <access_token> None

Path Parameters

Key Description Example Default
account_id
Required | string

The account ID

123456 None

Query Parameter

Key Description Example Default
start:gte
Required | string

Filter records by start date (greater equal or equal to)

2019-01-01 00:00:00 None
start:lte
Required | string

Filter records by start date (less equal or equal to)

2019-01-01 00:00:00 None
end:gte
string

Filter records by end date (greater equal or equal to)

2019-01-01 00:00:00 None
end:lte
string

Filter records by end date (less equal or equal to)

2019-01-01 00:00:00 None
page_size
Required | number

Number of records per page

10 10
page
Required | number

Current page number

10 0
to
string

Filter by called number

17325550100 None
from
string

Filter by source number

17325550100 None
source_user
string

Filter by source user

None None
destination_user
string

Filter by destination user

None None
direction
string

Filter by call direction.


Must be one of: Inbound or Outbound
Inbound None

View response field descriptions

Response Fields

Field Description
page_size
number

Number of records per page

page
number

Current page number

total_pages
number

Total number of pages

total_items
number

Total number of records

_embedded
object
Field Description
call_logs
array of objects
Field Description
id
string

Unique identifier of the call

in_network
boolean

Indicates if call was on/off network

international
boolean

Indicates if call was international

from
string

Source number of the call

to
string

Destination number of the call

direction
string

Direction of the call

length
number

Duration of the call in seconds

start
string

Start time of the call

end
string

End time of the call

charge
number

Amount charged for the call

rate
number

Rate charged for the call

destination_device_name
string

Name of the destination device of the call

destination_user_full_name
string

Full name of the destination user of the call

destination_user
string

Destination user of the call

destination_sip_id
string

SIP ID of the destination device of the call

destination_extension
number

Destination extension of the call

source_device_name
string

Name of the source device of the call

source_user_full_name
string

Full name of the source user of the call

source_user
string

Source user of the call

source_sip_id
string

SIP ID of the source device of the call

source_extension
number

Source extension of the call

result
string

Result of the call

recorded
boolean

Indicates if call was recorded

{
  "page_size": 10,
  "page": 1,
  "total_pages": 10,
  "total_items": 100,
  "_links": {
    "first": {
      "href": "abc123"
    },
    "prev": {
      "href": "abc123"
    },
    "self": {
      "href": "abc123"
    },
    "next": {
      "href": "abc123"
    }
  },
  "_embedded": {
    "call_logs": [
      {
        "id": "f27b937d-6dde-441a-9595-006e7302eac1",
        "in_network": true,
        "international": false,
        "from": 17325550100,
        "to": 17325550100,
        "direction": "Inbound",
        "length": 60,
        "start": "2019-01-01 00:00:00",
        "end": "2019-01-01 00:00:00",
        "charge": 0,
        "rate": 0,
        "destination_device_name": "Smith",
        "destination_user_full_name": "John Smith",
        "destination_user": "JSmith",
        "destination_sip_id": "VH1111111",
        "destination_extension": 1000,
        "source_device_name": "Smith",
        "source_user_full_name": "John Smith",
        "source_user": "JSmith",
        "source_sip_id": "VH1111111",
        "source_extension": 1000,
        "result": "Answered",
        "recorded": true
      }
    ]
  }
}
{
  "status": 1,
  "title": "abc123",
  "instance": "abc123",
  "invalid_parameters": [
    {
      "name": "abc123",
      "reason": "abc123"
    }
  ]
}