iVvy Developer API
Home
Support
System Status
Login
Search…
API Documentation
Getting Started
Contacts & Companies
Get Contact List
Get Contact
Add or Update Contact
Get Contact Custom Field Definition
Get Company Custom Field Definition
Get Subscription Group List
Add Contacts To Subscription Group
Remove Contacts From Subscription Group
Get Company List
Get Company
Add or Update Company
Add or Update Lead
Event
Venue
Partner
Invoice
Account
CRM
Development Reference
Powered By
GitBook
Get Contact
post
[PlatformAddress]/api/1.0/contact?action=getContact
Get Contact
Example Request
This example request will obtain the details of the contact with the id "6"
1
{
2
"id"
:
6
3
}
Copied!
Returns
Property
Description
Type
id
The unique identifier for the contact
integer
firstName
The contact’s first name
string
lastName
The contact’s last name
string
email
The contact’s email address
string
phone
The contact’s phone number
integer
status
The contact's
email status
​
enum
smsStatus
The contact’s
sms status
​
enum
customFields
The custom field information for the contact. This is an array of fields, each an object with the
keys
.
array
groups
The subscription group information for the contact.
array
companies
This will an array company ids to which the contact belongs.
array
companiesData
This will an array company containing id and businessName for each company to which the contact belongs.
array
externalId
This will be an external id of the contact
integer
modifiedDate
The modified date of the contact
date
eventInvitations
An array of events the contact has been invited to. Each element of the array is an object with
the event invitations fields
​
array
eventRegistrations
An array of events the contact has registered for. Each element of the array is an object with
the event registration fields
.
array
Status Options - Email Registration Status
The status is the record of whether the contact has opted in to email communication.
#
Description
1
Subscribed
2
Unsubscribed
3
Bounced
4
Registering
5
No Marketing
Sms status
The sms status is the record of whether the contact has opted in to sms communication.
#
Description
1
Subscribed
2
Unsubscribed
3
Failed
4
No Marketing
Custom Fields Keys
Keys
fieldId
displayName
value
Event Invitations
Property
Description
eventId
The event identifier of the invitation
eventCode
The code of the event of the invitation
eventStartDateTime
The timestamp the event is starting
inviteLinkYes
Invitation link for the Yes response for this contact to the event
inviteLinkNo
Invitation link for No response for this contact to the event
response
The contacts response to the invitation.
List of response values
.
Event Invitations Response values
#
Description
U
Undecided
Y
Yes
N
No
Event Registrations Details
Property
Description
eventId
The event identifier of the registration
eventCode
The code of the event of the registration
eventStartDateTime
The timestamp the event is starting
registrationId
The unique identifier of the registration
currentStatus
​
The status of the registration
​
confirmedDate
Timestamp of the date the registration was confirmed
isPaymentWaiting
If the registration is payment waiting or not
printTicketUrl
The URL the registrations tickets
printTicketUrlPdf
Link to the PDF for the registrations tickets
attendeeCount
Total number of attendees for this registration
invoiceUrl
The URL for the registration primary invoice
invoiceUrlPdf
Link to the PDF for the registration primary invoice
guestDetails
An array of objects with
the guest details.
​
invoices
The list of invoices associated with the registration. Each element of the array is an object with
the invoice fields.
​
Event Registration Status (currentStatus)
#
Description
2
Completed
3
Cancelled
4
Payment Required
Guest Details
Property
Description
contactId
The identifier for the contact if known
fullName
Name of guest
email
Email address of guest
attended
If the contact has attended the event
attendedDateTime
When the contact attended the event
Invoice Details
Property
Description
id
The unique identifier for the invoice
reference
The reference number of the invoice
title
The title of the invoice
currentStatus
The current status of the invoice. The value of this field will be
one of the following current status
.
description
The description of the invoice
currency
The currency of the values of this invoice
totalCost
The total amount of the invoice
totalPaid
How much has been paid off the invoice
invoiceUrl
The URL for the invoice
invoiceUrlPdf
The URL for the invoice pdf
Invoice current status
#
Description
0
Not Paid
1
Unconfirmed Paid
2
Written Off
3
Failed
4
Cancelled
5
Refunded
The result from this call will be a
collection
of all the events the user has access to. This call also accepts the
pagination
and
filter
properties.
Throws
Code
Description
Specific Code: 24096
Unable to find contact
The contact identifier must be provided to fetch a specific contact from the system.
Previous
Get Contact List
Next
Add or Update Contact
Last modified
8mo ago
Copy link
Contents
post
Get Contact
Example Request
Returns
Status Options - Email Registration Status
Sms status
Custom Fields Keys
Event Invitations
Event Registrations Details
Invoice Details
Throws