calls

Get call details

Returns the full call record with all relations loaded: transactions (billing), agent, voicemails, dataCollections, evaluations, tasks, analysis, followUps, plus computed fields isFavorite, shareHash, and a plain-text transcription rendered from roleplayTranscript. For in-progress calls some fields (finalSummary, minutesUsed) may be partial.

get/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/calls/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Call ID

Response

idstring required
createdAtstring date-time

When the call was created

userIdstring required
phoneNumberstring required

Phone number to call

source'LEGACY_UNKNOWN' | 'MANUAL_SCHEDULING' | 'CHAT' | 'POST_CALL_ACTION' | 'CONTACT_ACTION' | 'INTEGRATION' | 'CAMPAIGN' | 'USER_COPY' | 'SMART_RETRY' | 'RECURRING' | 'AGENT_TEST' | 'ADMIN_COPY' required

How the outbound call was created

callFromstring

Call from #

goalstring required

Call goal

goalStatus'UNKNOWN' | 'SUCCESS' | 'FAILED' required

Goal achievement status

scheduledAtstring date-time required

Call scheduled at

titlestring required

Call title

status'QUEUED' | 'IN_PROGRESS' | 'AWAITING_CONNECTION' | 'SUCCESS' | 'FAILED' | 'NOT_STARTED' | 'CANCELLED' | 'CALL_TRANSFERRED' required

Call status

additionalContextstring

Additional context

minutesUsednumber

Minutes used

voicestring

Voice used for the call

retryAfterMinutesnumber

Retry after minutes

maxDurationMinutesnumber

Max duration of the call in minutes

doWeNeedToRetryboolean

Do we need to retry the call

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

shortFinalSummarystring

Short final summary

placeWhereToCallstring

Place where to call

isCallTransferredboolean

Whether the call is transferred

voiceSpeednumber

Voice speed

callTypingSoundboolean

Typing sound

callBackgroundSoundboolean

Background sound

recommendedNextActionstring

Recommended next action (AI generated)

testCallboolean

Test call

isFavoriteboolean

Is this call favorited by the user

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"
      }
    ]
  },
  "matchedFields": [
    "phone",
    "summary",
    "title",
    "goal"
  ],
  "contactId": "123e4567-e89b-12d3-a456-426614174000"
}

Changes

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