incoming-calls

Get incoming call details

Returns the full inbound call record with all relations: transcript, finalSummary, agent config used, dataCollections (structured data extracted by the AI), followUps and tasks created during the call (both filtered to non-deleted and sorted newest first). If the call is still IN_PROGRESS some fields may be partial.

get/incoming-calls/{id}

Request

  • Base URL: https://be.skipcalls.com (the document declares no server; this is the origin it was published from)
  • URL: https://be.skipcalls.com/incoming-calls/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Call ID

Response

idstring required
userIdstring required
phoneNumberFromstring required

Phone number from call

createdAtstring date-time required

Started at

titlestring

Call title

callerNamestring

Caller name

status'FINISHED' | 'PROCESSED' | 'FAILED' | 'IN_PROGRESS' required

Call status

handling'RECEPTIONIST' | 'PERSONAL_VOICEMAIL' required

Who took the call: the AI receptionist, or the Skip AI voicemail for a contact that skips AI

minutesUsednumber

Minutes used

recordingUrlstring

Recording URL

userRatingboolean

User rating, where true is good and false is bad. null is no rating.

reviewedAtstring date-time

Reviewed at

finalSummarystring

Final summary

transcriptstring

Transcript in plain text

recommendedNextActionstring

Recommended next action

testCallboolean

Test call

isFavoriteboolean

Is this call favorited by the user

isSpamboolean

Whether the call is looks like spam or unwanted call

wasValuableboolean

Whether the incoming call was detected as valuable

callInterceptedByUserboolean

Whether the call was intercepted by the user

shareHashstring

Share hash for public sharing

matchedFieldsstring[]

Fields that matched the search query (only present in search results)

notesstring

User manual notes about this call (max 400 chars)

contactIdstring

Linked contact ID

Example response

{
  "agent": {
    "tools": [
      {
        "tool": {
          "toolType": "HTTP"
        }
      }
    ],
    "phoneNumbers": [
      {
        "createdAt": "2021-01-01T00:00:00Z",
        "updatedAt": "2021-01-01T00:00:00Z",
        "phoneNumber": "+1234567890",
        "country": "US",
        "agentId": "123",
        "direction": "INCOMING"
      }
    ]
  },
  "phoneNumberTo": {
    "createdAt": "2021-01-01T00:00:00Z",
    "updatedAt": "2021-01-01T00:00:00Z",
    "phoneNumber": "+1234567890",
    "country": "US",
    "agentId": "123",
    "direction": "INCOMING"
  },
  "matchedFields": [
    "phone",
    "summary",
    "title",
    "caller"
  ],
  "contactId": "123e4567-e89b-12d3-a456-426614174000"
}

Changes

No recorded changes to this operation across all 1 revision of this API.