- Programmatic API (API Key)
- Account & Pricing
- Sender IDs
- Send SMS
- OTP Verification
- SMS Status
- WhatsApp
- Viber Business Messaging
- Link Shortener
- Account
- Team Members
- Gets all business members for the current business (invited, active, deactivated). Invited appear first.
- Assigns a sender ID to a business member
- Invites a new member to the business by email. Only the business (owner) can invite.
- Gets all businesses where the current user is a member
- Updates the full set of sender IDs assigned to a business member
- Gets a single business member by id (including assigned senders)
- Deactivates a team member and restricts their access
- Registration
- Reference Data
- Authentication
- Verification & Password
- Profile
- Returns current customer user
- Returns customer user
- Updates customer user info
- Marks customer user as deleted
- Updates customer user admin For remove admin set adminId to null
- Updates customer user company info
- Updates customer user email and sends confirmation code to the new email
- Updates customer user open sender
- Updates customer user password
- Updates customer user phone number and sends confirmation code to the new phone number
- Two-Factor
- Team Members
- Templates & Content
- Sender IDs & Pricing
- Telephony
- DID Numbers
- Purchase & Provisioning
- Assignments
- List DID assignments owned by the caller's scope, optionally filtered by tenant or assigned user.
- One-shot health check for every assignment in the caller's scope. Returns per-DID SIP state flags so the FE can flag rows whose DB status says "Provisioned" but whose actual SIP routing is missing (drift caused by manual admin changes, bad cancels, etc.).
- Returns the caller's DID-management permissions for their active tenant. Used by the FE to gate scope-edit UI without second-guessing JWT roles or user-object shapes.
- Get a single DID assignment including its stored SIP password.
- Update fields on a DID assignment. ExtensionNumber is optional; null leaves the existing value untouched. SIP credentials live on the PbxTenant — rotate them via PUT /api/pbx-tenants/{id}.
- Unassign a DID — removes the assignment row. Does not cancel the underlying purchase order.
- Cancel a purchased DID and trigger a wallet refund. Tears down the SIP routing for the DID (inbound rule, trunk assignees, user outbound_caller_ids entry), cancels the DID order, and removes the local assignment row. The wallet refund itself lands when re
- Re-runs SIP provisioning for an existing assignment. Idempotent: safe to call repeatedly. Use to recover from drift when the DB says Provisioned but inbound calls don't land.
- Replace the scope of a DID assignment. Body is { scope, userIds? } where scope is one of "Unassigned", "Business", "Users". userIds is required when scope = Users and must be empty otherwise. The set is replaced atomically — passing a different list wipes
- Set this assignment's DID as the user's preferred outbound caller ID on SIP. Other DIDs keep working for inbound, but outbound calls from the extension will now stamp this number.
- Catalog
- List DID cities for a selected country or region.
- List DID countries that can be used to build a search flow.
- List DID DID groups that can later be used for available DID searches.
- Get DID compliance requirements for a country and DID group type.
- Search available DID numbers from DID using country, city, group, and number filters.
- Compliance
- Orders
- Reservations
- PBX Tenants
- SIP Voice
- Monitoring
- Real-time presence snapshot
- Queue state for dashboard widget
- Returns the caller's tenant CDRs (call detail records), paged. Scoped to the active PbxTenant resolved from the JWT access scope — no partner credentials required. Mirrors the partner-API GET /api/partners/pbx-cdrs but with user-context auth, suitable for
- Get presence snapshot for tenant users/extensions
- Get queue state snapshot
- Get voicemail summary
- Calls
- Session
- Monitoring
- DID Numbers
- Email Messaging
- Notifications & Statistics
- API Integration
- Payments
- SMS Messaging
- Social Platform
- Connections
- Lists all social connections for an internal account.
- Returns one social channel by identifier.
- Disconnects a single channel without removing the full provider connection.
- Returns the latest webhook subscription status known for a channel.
- Returns one provider connection by identifier.
- Disconnects an entire provider connection and all related channels.
- Refreshes provider tokens for a connection when the provider supports token refresh.
- Re-discovers channels for an existing connection.
- Returns the list of social providers supported by this API.
- Inbox
- Returns the unified inbox for an internal account with optional provider, channel, and unread filters.
- Lists normalized conversations for a channel.
- Pulls the latest provider conversations for a channel into the normalized inbox.
- Returns one normalized conversation.
- Assigns or reassigns a conversation to an internal user.
- Closes a resolved conversation.
- Returns workflow history for a conversation.
- Marks the conversation as read by the business. Sends sender_action=mark_seen to Meta so the customer sees a "Seen" indicator, and clears the local IsUnread flag plus per-message Read status. Idempotent.
- Lists normalized messages for a conversation.
- Reopens a resolved or closed conversation back into the assigned state.
- Sends a reply through the underlying provider and stores the outgoing message locally. Submit as multipart/form-data with optional `Text` and zero or more `Attachments` file parts. At least one of text or attachments is required. Each attachment must be 2
- Resolves an assigned or in-progress conversation.
- Moves an assigned conversation into the in-progress workflow state.
- Pulls the latest provider messages for a conversation.
- Facebook
- Starts the Facebook connect flow by generating a provider authorization URL. Optionally accepts a redirectUri to override the platform default (Meta:RedirectUriFacebook). The value provided here is the one Meta will redirect to after auth, and must match
- Completes the Facebook connect flow with the short-lived token obtained from Meta.
- Instagram
- Starts the Instagram connect flow by generating a provider authorization URL. Optionally accepts a redirectUri to override the platform default (Meta:RedirectUriInstagram). The value provided here is the one Meta will redirect to after auth, and must matc
- Dumps the server-side state of an Instagram channel (token introspection, Page→IG link, IG account, user permissions, app + page webhook subscriptions, and a raw conversations probe) plus inferred hints. Use this when sync returns 200 with empty data to s
- Completes the Instagram connect flow with the short-lived token obtained from Meta.
- Telegram
- Creates or reconnects a Telegram channel and configures its webhook.
- Partially updates Telegram channel configuration.
- Disables a Telegram channel.
- Creates or updates Telegram business connection metadata for a channel.
- Lists Telegram business connections linked to a channel.
- Returns Telegram webhook diagnostics for support and incident handling.
- Returns Telegram channel status and webhook provisioning state.
- Connections
- Campaigns (v2)
- Contacts (v2)
- Contacts
- Details
- Messages
- Dashboard (v2)
- Segments (v2)
- Schemas
- V2CampaignTelegramVerificationStatusModel
- TemplateFilteringSortingModel
- SuccessResponseModelOfDidwwDidGroupDto
- SocialChannelType
- UserEmailConfirmCodeSendModel
- V2ContactDetailType
- CommunicationType
- RateFilteringSortingModel
- PagedListGetModelOfV2ContactGetModel
- SuccessResponseModelOfPagedListGetModelOfRateGetModel
- MarkConversationInProgressRequestDto
- SuccessResponseModelOfV2ShortLinkDomainGetModel
- PagedListGetModelOfNotificationGetModel
- SenderIdFilteringSortingModel
- SuccessResponseModelOfSipQueueSnapshotDto
- V2CampaignChannelGetModel
- DidSearchItemDto
- SuccessResponseModelOfCannedResponseGetModel
- V2CampaignExportRequestModel
- WebhookSubscriptionStatusDto
- SuccessResponseModelOfDidwwReservationDto
- SuccessResponseModelOfPagedListGetModelOfSmsDataRecordGetModel
- SocialProvider
- UpsertTelegramBusinessConnectionRequestDto
- SipPresenceSnapshotDto
- SmsDataRecordGetModel
- SuccessResponseModelOfPortSipQueueSnapshotDto
- PbxTenantWebhookUpdateModel
- V2CampaignChannelUpdateModel
- ConnectFacebookRequestDto
- SuccessResponseModelOfDidPurchaseResultDto
- SuccessResponseModelOfSenderIdGetModel
- V2SegmentUpdateModel
- SuccessResponseModelOfListOfBusinessMemberGetModel
- TelegramBusinessConnectionDto
- V2ContactCsvDuplicateModel
- SuccessResponseModelOfPortSipCallActionResultDto
- PagedListGetModelOfRateGetModel
- V2ContactMessageExportRequestModel
- V2DashboardTrendsChannelModel
- DataRecordFilterModel
- SuccessResponseModelOfDidReservationDto
- SyncConversationsResponseDto
- SipTransferRequestDto
- PortSipInternalCallRequestDto
- InstagramDiagnosticsDto
- UpdateTelegramChannelRequestDto
- ReopenConversationRequestDto
- CannedResponseUpdateModel
- SuccessResponseModelOfSipCallActionResultDto
- ProblemDetails
- PaymentCreateModel
- ClickEventDto
- PagedListGetModelOfV2CampaignListItemModel
- DidwwReservationsRequestDto
- CustomerUserEmailRegisterModel
- SuccessResponseModelOfNotificationListGetModel
- PbxTenantFilteringSortingModel
- UpdateWebhookSubscriptionRequest
- SuccessResponseModelOfDidAssignmentCancelResultDto
- SocialConnectionDto
- NotificationListGetModel
- ErrorResponseModel
- UserPhoneNumberConfirmModel
- V2ContactCreateModel
- SuccessResponseModelOfPortSipVoicemailSummaryDto
- SuccessResponseModelOfPagedListGetModelOfV2CampaignMessageListItemModel
- UserTwoFactorSettingsGetModel
- SuccessResponseModelOfV2CampaignCsvParseResultModel
- V2SegmentContactsUpdateModel
- TokenStatus
- TelegramChannelStatusDto
- SuccessResponseModelOfV2ContactCsvImportResultModel
- DidPurchaseResultDto
- SuccessResponseModelOfEmailPriceGetModel
- CountryGetModel
- CustomerUserGetModel
- SuccessResponseModelOfSipPresenceSnapshotDto
- PbxTenantGetModel
- V2ContactCsvImportResultModel
- V2ContactDetailCreateModel
- SuccessResponseModelOfCountryGetModel
- V2CampaignUpdateModel
- SocialConversationDto
- UnifiedInboxDto
- ProviderType
- AuthUrlResponseDto
- CustomerUserLoginModel
- SuccessResponseModelOfCustomerUserLoginResultModel
- CreateWebhookSubscriptionRequest
- WebhookSubscriptionResponse
- SuccessResponseModelOfPagedListGetModelOfPbxCdrResponseModel
- SuccessResponseModelOfV2CampaignGetModel
- SuccessResponseModelOfPagedListGetModelOfSmsConversationGetModel
- PagedListGetModelOfCurrencyGetModel
- PortSipQueueSnapshotDto
- V2ContactDetailUpdateModel
- ConnectInstagramRequestDto
- V2ContactUpdateModel
- WhatsAppStatus
- UserPasswordResetModel
- PagedListGetModelOfPaymentGetModel
- V2ContactDetailExportRequestModel
- EmailDataRecordGetModel
- SuccessResponseModelOfDidSearchItemDto
- SmsConversationGetModel
- UserEmailModel
- DidReservationsRequestDto
- SenderIdType
- LinkAnalyticsResponse
- SipVoicemailSummaryDto
- CustomerUserLoginResultModel
- V2ContactMessageListFilterModel
- SuccessResponseModelOfPortSipSessionBootstrapResponseDto
- FilterComparer
- DidwwCountryDto
- SuccessResponseModelOfV2SegmentGetModel
- SipTeardownStatusDto
- PagedListGetModelOfV2ContactDetailGetModel
- PagedListGetModelOfV2CampaignMessageListItemModel
- SenderIdGetModel
- PaymentDirection
- PortSipTransferRequestDto
- TrafficType
- UpdateLinkRequest
- SuccessResponseModelOfPagedListGetModelOfV2CampaignListItemModel
- DidwwCityDto
- PaymentCreateResultGetModel
- WhatsAppTemplateCategory
- SuccessResponseModelOfDidComplianceRequirementsDto
- PagedListGetModelOfSmsConversationGetModel
- V2SegmentListFilterModel
- V2CampaignMessageExportRequestModel
- ConversationStatus
- PbxCdrResponseModel
- V2ExportMode
- V2SegmentGetModel
- DidwwOrderStatusDto
- V2ContactDetailListFilterModel
- SuccessResponseModelOfStatisticSenderIdExpensesGetModel
- DidOrderStatusDto
- V2ShortLinkDomainGetModel
- SenderIdStatus
- CustomerUserTwoFactorLoginModel
- SuccessResponseModelOfSipVoicemailSummaryDto
- PagedListGetModelOfV2ContactMessageListItemModel
- SuccessResponseModelOfDidwwCountryDto
- DidCityDto
- SuccessResponseModelOfObject
- SuccessResponseModelOfSmsDataRecordGetModel
- CustomerUserRegisterModel
- DidAssignmentResultDto
- SipSessionBootstrapResponseDto
- V2DashboardOtpStatsModel
- SuccessResponseModelOfPagedListGetModelOfSenderIdGetModel
- SuccessResponseModelOfStatisticBalanceGetModel
- StatisticSenderIdExpensesGetModel
- SocialMessageDto
- TelegramWebhookDiagnosticDto
- AdminUserGetModel
- PagedListGetModelOfTemplateGetModel
- SuccessResponseModelOfPagedListGetModelOfTemplateGetModel
- V2CampaignPreCreationPriceModel
- SuccessResponseModelOfPagedListGetModelOfCannedResponseGetModel
- CreateLinkRequest
- DidDidGroupDto
- SuccessResponseModelOfPbxTenantGetModel
- ProblemDetails_link
- SenderIdTrafficTypeGetModel
- SuccessResponseModelOfDidwwOrderStatusDto
- V2CampaignListItemModel
- BusinessMemberAcceptInvitationModel
- SuccessResponseModelOfV2CampaignPricePreviewModel
- UserPasswordUpdateModel
- MessageStatus
- SenderIdTypeGetModel
- SocialChannelDto
- DidSearchRequestDto
- DidStockKeepingUnitDto
- SipHoldResumeRequestDto
- SuccessResponseModelOfPagedListGetModelOfAreaMccMncGetModel
- SuccessResponseModelOfV2CampaignMessageInfoModel
- TokenGetModel
- PortSipSessionBootstrapResponseDto
- PaymentType
- V2CampaignChannelCreateModel
- StatisticBalanceGetModel
- V2CampaignPricePreviewModel
- RateGetModel
- SocialConversationStatusHistoryDto
- SuccessResponseModelOfPaymentListGetModelOfPaymentGetModel
- PaymentStatusUpdateModel
- V2SegmentCreateModel
- SuccessResponseModelOfBusinessMemberGetModel
- SuccessResponseModelOfSipSessionBootstrapResponseDto
- AreaMccMncFilterModel
- CannedResponseGetModel
- SuccessResponseModelOfString
- PortSipPresenceSnapshotDto
- MessageDirection
- TokenRefreshModel
- DidAssignmentHealthDto
- PagedListGetModelOfEmailDataRecordGetModel
- SocialProviderDto
- PbxTenantCreateModel
- SuccessResponseModelOfV2CampaignTelegramVerificationStatusModel
- EmailPriceGetModel
- ResyncChannelsResponseDto
- SenderIdMediaAttachmentGetModel
- TemplateUpdateModel
- SuccessResponseModelOfPagedListGetModelOfV2SegmentGetModel
- SipCallActionResultDto
- CustomerUserSmsTwoFaLoginModel
- PortSipVoicemailSummaryDto
- SuccessResponseModelOfDidCityDto
- IFormFile
- DidwwComplianceRequirementsDto
- SipMuteRequestDto
- V2CampaignGetModel
- PagedListGetModelOfSenderIdPriceGetModel
- SuccessResponseModelOfDidCountryDto
- SuccessResponseModelOfEmailDataRecordGetModel
- PagedListGetModelOfV2SegmentGetModel
- PartnerCustomerUserLoginModel
- CreateTelegramChannelRequestDto
- V2ContactExportRequestModel
- DidwwReservationDto
- SuccessResponseModelOfTokenGetModel
- PaginationModel
- SyncMessagesResponseDto
- SuccessResponseModelOfIEnumerableOfLong
- SuccessResponseModelOfPaymentGetModel
- SortingModel
- V2CampaignChannelSummaryModel
- SenderIdPriceGetModel
- DidwwStockKeepingUnitDto
- SuccessResponseModelOfIReadOnlyCollectionOfDidAssignmentHealthDto
- V2SegmentExportRequestModel
- AssignConversationRequestDto
- DidwwDidGroupDto
- CurrencyGetModel
- JsonElement
- V2DashboardKpisModel
- DidComplianceRequirementsDto
- SuccessResponseModelOfTemplateGetModel
- SuccessResponseModelOfDidAssignmentResultDto
- DidAssignmentUpdateDto
- V2CampaignMessageInfoModel
- CustomerUserCompanyUpdateModel
- AreaMccMncGetModel
- UserPhoneNumberConfirmCodeSendModel
- V2DashboardOtpChannelModel
- CampaignAnalyticsListRequest
- DidAssignmentScopeUpdateDto
- PortSipMuteRequestDto
- PaymentListGetModelOfPaymentGetModel
- V2CampaignCsvParseResultModel
- V2CampaignTelegramVerifyCodeModel
- ReplyMessageResponseDto
- SipStartCallRequestDto
- NotificationGetModel
- SuccessResponseModelOfPaymentCreateResultGetModel
- V2ContactDetailGetModel
- UserEmailConfirmModel
- V2DashboardChannelBreakdownModel
- CustomerUserUpdateModel
- DidReservationDto
- SuccessResponseModelOfDidwwComplianceRequirementsDto
- SuccessResponseModelOfPagedListGetModelOfCurrencyGetModel
- DiagnosticProbeDto
- ContactAnalyticsResponse
- SuccessResponseModelOfLong
- BusinessMemberGetModel
- PortSipTeardownStatusDto
- LinkResponse
- SuccessResponseModelOfCustomerUserGetModel
- V2ContactGetModel
- SuccessResponseModelOfBoolean
- V2ContactDetailStatus
- SuccessResponseModelOfPagedListGetModelOfSenderIdPriceGetModel
- V2CampaignChannelPricePreviewModel
- PagedListGetModelOfPbxTenantGetModel
- PagedListGetModelOfCannedResponseGetModel
- SuccessResponseModelOfUserTwoFactorSettingsGetModel
- PagedListGetModelOfSenderIdGetModel
- SipInternalCallRequestDto
- V2DashboardTrendsDataPointModel
- TemplateGetBaseModel
- SenderIdViberLogoGetModel
- CloseConversationRequestDto
- PortSipCallActionResultDto
- UserPhoneNumberModel
- V2DashboardChannelFunnelModel
- ResolveConversationRequestDto
- TemplateGetModel
- ConversationStatusHistoryActionType
- PagedListGetModelOfPbxCdrResponseModel
- PagedListGetModelOfSmsDataRecordGetModel
- PaymentGetModel
- SuccessResponseModelOfDidAssignmentResponseDto
- PbxTenantWebhookGetModel
- V2CampaignListFilterModel
- BusinessMemberUpdateSenderAssignmentsModel
- SuccessResponseModelOfPbxTenantWebhookGetModel
- CustomerTrunkBaseGetModel
- V2CampaignMessageListFilterModel
- DidAssignmentRequestDto
- SuccessResponseModelOfDidPermissionsDto
- DidPurchaseRequestDto
- CampaignAnalyticsResponse
- V2CampaignCreateModel
- BusinessType
- PaymentFilterModel
- PortSipStartCallRequestDto
- V2CampaignMessageInfoRequest
- TemplateMediaAttachmentGetModel
- SuccessResponseModelOfPortSipPresenceSnapshotDto
- DidPermissionsDto
- UserTwoFactorSettingsUpdateModel
- SuccessResponseModelOfV2CampaignRecipientPreviewModel
- PortSipHoldResumeRequestDto
- FilteringModel
- MessageType
- SipQueueSnapshotDto
- SuccessResponseModelOfPagedListGetModelOfV2ContactMessageListItemModel
- TemplateStatus
- SuccessResponseModelOfCustomerTrunkBaseGetModel
- CannedResponseCreateModel
- FilteringSortingModel
- DidCountryDto
- SuccessResponseModelOfDidProvisioningResultDto
- SuccessResponseModelOfDidwwCityDto
- V2ContactListFilterModel
- V2CampaignMessageListItemModel
- TwoFactorMethod
- V2DashboardTrendsModel
- ComplianceRequestCreateDto
- V2ContactMessageListItemModel
- SuccessResponseModelOfDidOrderStatusDto
- WebhookDeliveryResponse
- BusinessMemberAssignSenderIdModel
- ConversationFilteringSortingModel
- DidProvisioningResultDto
- SuccessResponseModelOfDidDidGroupDto
- SuccessResponseModelOfPagedListGetModelOfPbxTenantGetModel
- UserPhoneNumberUpdateModel
- SuccessResponseModelOfPagedListGetModelOfEmailDataRecordGetModel
- V2CampaignRecipientPreviewModel
- SuccessResponseModelOfV2ContactGetModel
- SuccessResponseModelOfPagedListGetModelOfV2ContactDetailGetModel
- DidAssignmentCancelResultDto
- SortDirection
- UserEmailUpdateModel
- Solution
- PagedListGetModelOfAreaMccMncGetModel
- BusinessMemberSenderIdGetModel
- V2CampaignUnresolvableRecipientModel
- RateDetailGetModel
- BusinessMemberCreateModel
- RefreshTokenResponseDto
- SuccessResponseModelOfPagedListGetModelOfV2ContactGetModel
- DidAssignmentResponseDto
List contacts (filtered/paged)
POST
https://api.veloconnect.me/api/v2/contacts/query
Contacts (v2)
Last modified:2026-06-01 19:28:25
V2ContactListFilterModelSuccessResponseModelOfPagedListGetModelOfV2ContactGetModelRequest
Authorization
or
Body Params application/jsonRequired
Examples
Responses
🟢200OK
application/json
Bodyapplication/json
🟠400Bad Request
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.veloconnect.me/api/v2/contacts/query' \
--header 'Content-Type: application/json' \
--data '{
"pageNumber": 0,
"pageSize": 0,
"search": "string",
"channel": "string",
"country": "string",
"ageGroup": "string",
"gender": "string",
"contactId": 0,
"segmentId": 0,
"excludeSegmentId": 0,
"sortBy": "string",
"sortDescending": true
}'Response Response Example
200 - Success Example
{
"data": [
{
"items": [
{
"id": null,
"businessId": null,
"firstName": null,
"lastName": null,
"middleName": null,
"dateOfBirth": null,
"gender": null,
"companyName": null,
"jobTitle": null,
"notes": null,
"externalReference": null,
"createdAt": null,
"createdBy": null,
"modifiedAt": null,
"modifiedBy": null,
"details": null
}
],
"totalCount": 0,
"pageSize": 0,
"pageNumber": 0
}
]
}Modified at 2026-06-01 19:28:25