Authentication

Postman Authentication sample

An authentication call enables you to gain access to your Network instance.

Authentication consists of the following steps:

You provide a Network user name and password in the body of the POST request, and receive a session ID in response.
You must pass this session ID as the value for the authorization HTTP header for all subsequent API requests.

Authenticate

This API enables user authentication. User credentials are passed using POST data; for example, with the -d parameter in a curl request.

You can only authenticate with a Network user name defined by an administrator.

Endpoint URL

https://DNS/api/version/auth

DNS - is the URL for your API service
version - is the API version

POST data
username: The Network user ID; for example, john.smith@veevanetwork.com.
password: The Network password for the user ID.

Response
responseStatus: The status of the response.
sessionId: The session ID for subsequent API calls. This should be set with an authorization header.
userId: An ID number for the authenticated user.
networkId: An ID number for the Network instance most recently accessed by the authenticated user.
networkIds: Details about each Network instance the authenticated user can access:

id - An ID number for the authenticated user.

name - The name of the Network instance.

url - The Network URL used for subsequent API calls.

Was this helpful?

Tell us more

Select all that apply. More to say? Send a message to our writers.

Parameters are missing

API usage is not clear

The examples aren't helpful

Additional feedback?

Name Role Email Message** denotes a required field

Thanks, we appreciate your feedback!

If the information on this page is unclear, consider sending a message to our writers.

Thanks, we appreciate your feedback!

curl -X POST https://my.veevanetwork.com/api/v31.0/auth \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json" \
-d "username={username}&password={password}"

{
   "networkIds" : [
      {
         "name" : "VEEVANETWORK",
         "url" : "https://my.veevanetwork.com/api",
         "id" : 500
      }
   ],
   "networkId" : "500",
   "userId" : 552,
   "responseStatus" : "SUCCESS",
   "sessionId" : "2DC1C11F33010EBE49042B9CA1E9C74B6ED9E7C169D08C4B395B2C5459CD1C133BBFE77DBDEE8A7BEEC6C3D011E180303A2D86121A122D978174229F9F5B3350E0BE80F2C5EB53F75A930A636DBAE530"
}

Associating custom keys

This API enables you to associate or disassociate custom keys with entities and child entities.

Associate custom key to entity

This API enables you to submit external key identifiers when new HCPs or HCOs are downloaded from Network without going through the full change request process.

The external identifier is associated to the entity (vid_key) specified in the URL.

This API requires system administrator or API-only permissions.

https://DNS/api/version/entities/vid_key/custom_keys

DNS is the URL for your API service
version is the API version
vid_key is the key for the entity you want to associate

Parameters
custom_key_source_type: The source of the new key.
custom_key_item_type: The item type for the new key.
custom_key_value: The value for the new key.
system_name: The name of the system for the new key.

Response
responseStatus: The status of the response.

Notes

responseStatus returns a failure if any standard errors occur or:

vid_key does not represent an existing entity.
The entity specified by vid_key is not a supported entity.
The keys specified are already in use by a different entity.

Changelog

system_name parameter introduced in version 3.0.

Was this helpful?

Tell us more

Select all that apply. More to say? Send a message to our writers.

Parameters are missing

API usage is not clear

The examples aren't helpful

Additional feedback?

Name Role Email Message** denotes a required field

Thanks, we appreciate your feedback!

If the information on this page is unclear, consider sending a message to our writers.

Thanks, we appreciate your feedback!

curl -X POST -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/entities/Network:Entity:932241745093790303/custom_keys?custom_key_source_type=HCO&custom_key_item_type=DCRID__v&custom_key_value=12345'

{
  "responseStatus": "SUCCESS"
}

Batch associate custom keys to entities

This API enables you to submit external key identifiers whenever new HCPs or HCOs are downloaded from Network without going through the full change request process.

The external identifiers are associated to the entities (vid_key) specified in the request.

This API requires system administrator or API-only permissions.

https://DNS/api/version/entities/custom_keys/associate/batch

DNS is the URL for your API service
version is the API version

This API takes no parameters.

POST data
entities: An array of objects:
vid_key - The external HCP or HCO vid_key
custom_key_source_type - The source of the new key.
custom_key_item_type - The item type for the new key.
custom_key_value - The value for the new key.
system_name - The name of the system for the new key.

Response
responseStatus: The status of the response.
errors: An array of error messages:
type - the error type.
message - a detailed message for the error type. This message is subject to change and is not contractual for error handling.

Notes

responseStatus returns a failure or a status of PARTIAL_SUCCESS if any standard errors occur or:

vid_key does not represent an existing entity.
The entity specified by vid_key is not a supported entity.
The keys specified are already in use by a different entity.
More than 500 operations are made in the rquest; batch calls are limited to 500 operations.

curl -i -H "Authorization: 57696C6C205261...6368204C6F7368" -H "Content-type: application/json" -X POST -d "@ckeys_postdata.json" 'https://my.veevanetwork.com/api/v33.0/entities/custom_keys/associate/batch'

{
  "entities": [
    {
      "vid_key": "Network:Entity:291256782200767488",
      "custom_key_source_type": "VCRM",
      "custom_key_item_type": "ENTITY",
      "custom_key_value": "123123123123",
      "system_name": "VCRM"
    },
    {
      "vid_key": "Network:Entity:291256782200767400",
      "custom_key_source_type": "VCRM",
      "custom_key_item_type": "ENTITY",
      "custom_key_value": "123456789",
      "system_name": "VCRM"
    },
    {
      "vid_key": "Network:Entity:291256796914385922",
      "custom_key_source_type": "VCRM",
      "custom_key_item_type": "ENTITY",
      "custom_key_value": "987654321",
      "system_name": "VCRM"
    }
  ]
}

{
  "responseStatus": "SUCCESS"
}

{
  "responseStatus": "PARTIAL_SUCCESS",
  "errors": [
    {
      "type": "INVALID_DATA",
      "message": "No entity found with the given Id 291256782200767400"
    }
  ]
}

Associate custom key to children

This API enables you to submit external key identifiers when new children (address, license, or parent HCOs) are downloaded from Network without going through the full change request process.

The external identifier is associated to the children (children_key) specified in the URL.

This API requires system administrator or API-only permissions.

https://DNS/api/version/entities/vid_key/children/children_key/custom_keys

DNS is the URL for your API service
version is the API version
children_key is the key of the child entities
vid_key is the key of the HCO you want to associate

Parameters
custom_key_source_type: The source of the new key.
custom_key_item_type: The item type for the new key.
custom_key_value: The value for the new key.
system_name: The name of the system for the new key.

Response
responseStatus: The status of the response.

Notes

responseStatus returns a failure if any standard errors occur or:

vid_key does not represent an existing entity.
children_key does not represent any existing child entities.
The entity specified by vid_key is not a supported entity.
The entity specified by children_key is not a supported child entity.
The keys specified are already in use by a different entity.

Changelog

system_name introduced in version 3.0.

curl -X POST -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/entities/Network:Entity:932241745093790303/custom_keys?custom_key_source_type=HCO&custom_key_item_type=DCRID__v&custom_key_value=12345'

{
  "responseStatus": "SUCCESS"
}

Batch associate custom key to children

This API enables you to submit external key identifiers when new children (address, license, or parent HCOs) are downloaded from Network without going through the full change request process.

The external identifiers are associated to the children (children_key) specified in the request.

This API requires system administrator or API-only permissions.

https://DNS/api/version/entities/children/custom_keys/associate/batch

DNS is the URL for your API service
version is the API version

This API takes no parameters.

POST data
entities: An array of objects:
vid_key - The external HCP or HCO vid_key
child_type - The child type (address, license, or parentHCO). To select a child by vid_key alone, specify the general type (children).
child_key - The vid_key of the child object.
custom_key_source_type - The source of the new key.
custom_key_item_type - The item type for the new key.
custom_key_value - The value for the new key.
system_name - The name of the system for the new key.

Response
responseStatus: The status of the response.
errors: An array of error messages:
type - the error type.
message - a detailed message for the error type. This message is subject to change and is not contractual for error handling.

Notes

responseStatus returns a failure or a status of PARTIAL_SUCCESS if any standard errors occur or:

vid_key does not represent an existing entity.
children_key does not represent any existing child entities.
The entity specified by vid_key is not a supported entity.
The entity specified by children_key is not a supported child entity.
The keys specified are already in use by a different entity.
More than 500 operations are made in the request; batch calls are limited to 500 operations.

curl -i -H "Authorization: 57696C6C205261...6368204C6F7368" -H "Content-type: application/json" -X POST -d "@childkeys_postdata.json" 'https://my.veevanetwork.com/api/v33.0/entities/children/custom_keys/associate/batch'

{
  "entities": [
    {
      "vid_key": "Network:Entity:291256782200767488",
      "child_type": "licenses",
      "child_key": "Network:License:291256858360939523",
      "custom_key_source_type": "VCRM",
      "custom_key_item_type": "LICENSE",
      "custom_key_value": "123456789",
      "system_name": "VCRM"
    },
    {
      "vid_key": "Network:Entity:291256748453397507",
      "child_type": "addresses",
      "child_key": "Network:Address:291256848747594752",
      "custom_key_source_type": "VCRM",
      "custom_key_item_type": "ADDRESS",
      "custom_key_value": "123123123123",
      "system_name": "VCRM"
    },
    {
      "vid_key": "Network:Entity:291256757999633408",
      "child_type": "parent_hcos",
      "child_key": "Network:ParentHCO:291256757999633600",
      "custom_key_source_type": "VCRM",
      "custom_key_item_type": "CHILDACCOUNT",
      "custom_key_value": "987654321",
      "system_name": "VCRM"
    }
  ]
}

{
  "responseStatus": "SUCCESS"
}

Disassociate custom key

This API enables you to deactivate external key identifiers for any entity (an HCP, HCO, Address, License, or ParentHCO) in Network without going through the full change request process.

The external identifier (vid_key) specified in the URL is disassociated from the entity.

This API requires system administrator or API-only permissions.

https://DNS/api/version/custom_keys/vid_key

DNS is the URL for your API service
version is the API version
vid_key is the key for the entity you want to deactivate

This API takes no parameters.

Response
responseStatus: The status of the response.

Notes

responseStatus returns a failure if any standard errors occur or:

vid_key does not represent an existing custom key.
The key specified is already inactive.

Inactivated keys will not match again; a new associate API call for an inactivated key will create a new key.

curl DELETE -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/custom_keys/MASTER__v:HCP:936779911995786851'

{
  "responseStatus": "SUCCESS"
}

Batch disassociate custom key

This API enables you to inactivate external key identifiers for any entity (HCP, HCO, Address, License, or ParentHCO) in Network without going through the full change request process.

The external identifier is disassociated from the entities (vid_key) specified in the request.

This API requires system administrator or API-only permissions.

https://DNS/api/version/custom_keys/disassociate/batch

DNS is the URL for your API service
version is the API version

This API takes no parameters.

POST data
entities: An array of objects:
vid_key - The external HCP, HCO, address, license, or parent HCO vid_key supplied by the client.

Response
responseStatus: The status of the response.
errors: An array of error messages:
type - the error type.
message - a detailed message for the error type. This message is subject to change and is not contractual for error handling.

Notes

responseStatus returns a failure or a status of PARTIAL_SUCCESS if any standard errors occur:

vid_key does not represent an existing entity.
Inactivated keys will not match again; a new associate API call for an inactivated key will create a new key.

Batch API calls are limited to 500 operations per call. Attempts to submit more operations result in a failure of all operations.

curl -i -H "Authorization: 57696C6C205261...6368204C6F7368" -H "Content-type: application/json" -X POST -d "@ckeys_postdata.json" 'https://my.veevanetwork.com/api/v33.0/custom_keys/disassociate/batch'

{
  "entities": [
    {
      "vid_key": "VCRM:ENTITY:291256782200767500"
    },
    {
      "vid_key": "VCRM:LICENSE:123456789"
    },
    {
      "vid_key": "VCRM:ADDRESS:123123123123"
    }
  ]
}

{
  "responseStatus": "SUCCESS"
}

Manage change requests

Change requests are the standard method used to submit changes in Network. They enable you to create change requests to add, update, merge, or split HCPs and HCOs. If successful, each change request record received is responded to with a unique Network change request ID and date/time value upon reception.

Address, license, and parent HCO information, including their custom keys, are part of each HCP and HCO. To add a new address, license, or parent HCO (including new custom keys) to either an HCP or HCO, you use the Create change request API. You can provide the vid_key of the HCP or HCO and the external ID of the new address, license, or parent HCO for more efficient processing.

Change request APIs to delete entities are not available, as information in Network cannot be deleted. For HCPs and HCOs, a change request for the Status field is the standard method to deactivate resources. Addresses, licenses, and parent HCOs follow the same procedure as part of the HCP or HCO in the Network data model.

The fields of any entity call are the properties for the corresponding entity. The metadata retrieve calls enable you view all fields for a particular entity. The data model also describes the fields required to create any resources, as well as any group of fields that must be submitted all together, if any of them changes (for example, address fields for regular mail).

Create a change request

This API enables you to create a Network change request to add or update an HCP or HCO and related entities (including addresses, licenses, or parent HCOs).

https://DNS/api/version/change_request

DNS - is the URL for your API service
version - is the API version

This API takes no parameters.

POST data
reserve_vid: Boolean type. Request to reserve a Veeva ID immediately when an add request is submitted.
metadata: Details about the request being made. The details are saved in the entity history if the change is accepted (an array of fields within itself):
creator - the name of the user that generated the change request
note - details about the change request
source - additional information about the source of the change request
system - the name of the system that generated the change request (used for reference aliases and other validation)
entity_type: The entity type of the change request (HCP or HCO).
vid_key: The external HCP or HCO vid_key supplied by the client and used for change request updates. Ignored if provided for add requests.
create_unverified: Override the workflow settings for creating unverified records. If True, an unverified record is created with the DCR. If False, only the DCR is created. If not specified, the workflow settings persist.
entity: Details of the changes, one per field, for the entity provided:
field - The Network API name of the HCP or HCO field.
value - The new value of the HCP or HCO field.
addresses__v - An array of change requests for addresses, one per address, for the entity provided:
vid_key - the address vid_key supplied by the client
field - The Network API name of the HCP or HCO Address field
value - the new value of the HCP or HCO Address field
licenses__v - An array of change requests for licenses, one per license, for the entity provided:
vid_key - the license vid_key supplied by the client
address_vid_key - the address vid_key to which the license is related, supplied by the client
address_index - the address index within the addresses__v object. Can be used when vid_key is not available. (The index is zero-based.)
field - The Network API name of the HCP or HCO License field
value - the new value of the HCP or HCO License field
parent_hcos__v - An array of change requests for parent HCOs, one per parent HCO, for the entity provided:
vid_key - the parent HCO vid_key supplied by the client
parent_hco_vid_key - the actual HCO vid_key of the parent, supplied by the client
field - The Network API name of the HCP or HCO ParentHCO field
value - the new value of the HCP or HCO ParentHCO field
custom_keys__v - An array of change requests for custom keys, one per custom key, for the entity provided:
vid_key - the custom key vid_key supplied by the client
field - The Network API name of the custom key field
value - the new value of the custom key field
attachments: Details for all change request attachments to include. Attachments are sent through the API using base64 encoding:
file_name - the image name and extension; for example, image1.png
file_caption - a description of the image
file_content_type - the type of file; for example, image/jpeg
format - the file format; defaults to base64 if not specified
file_source_id - an ID for external integration use
file_data - the base64 encoding for the image

Response
responseStatus: The status of the response from Network.
change_request_id: The ID of the change request generated in Network.

Notes

Addresses, licenses, and parent HCOs are an array of fields within themselves. There can be multiple addresses, licenses, or parent HCOs created for the same entity (HCP or HCO) at the same time.

curl -i -H "Authorization: 57696C6C205261...6368204C6F7368" -H "Content-type: application/json" -X POST -d "@dcrs_postdata.json" 'https://my.veevanetwork.com/api/v33.0/change_request'

        Sample POST data - Sample POST data - Add request  for an HCP with addresses, license, and parentHCO, with attachments
      

{
  "metadata": {
    "creator": "crmuser@pharma.com",
    "note": "John Smith is a new doctor in the Network Hospital",
    "source": "Veeva CRM"
  },
  "entity_type": "HCP",
  "entity": {
    "first_name__v": "John",
    "last_name__v": "Smith",
    "medical_degree__v": "DMD",
    "specialty_1__v": "OBY",
    "gender__v": "m",
    "email_1__v": "john.smith@hotmail.com",
    "addresses__v": [
      {
        "address_line_1__v": "326 Harolds Drive",
        "locality__v": "Huntsville",
        "ISO_3166_2__v": "US",
        "postal_code_primary__v": "35806",
        "is_primary_address__v": false
      }
    ],
    "licenses__v": [
      {
        "address_vid_key": "Network:Address:215249678634058760",
        "license_number__v": "1256987",
        "type__v": "ADDRESS",
        "type_value__v": "",
        "body__v": "ALMD",
        "effective_date__v": "2010-05-05",
        "expiration_date__v": "2013-12-31"
      }
    ],
    "parent_hcos__v": [
      {
        "parent_hco_vid_key": "Network:HCO:215249678634058752",
        "is_primary_relationship__v": false,
        "relationship_type__v": "10"
      }
    ],
    "attachments": [
      {
        "file_name": "196.heif.png",
        "file_caption": "HCP1",
        "file_content_type": "image/heif",
        "format": "base64",
        "file_source_id": "1688665744000",
        "file_data": "LDJ9NC1DNFkpN20y4tLmM0JVBERi0xLjQNCjUgMCBvYmoNCjw8DQovVHlwZSAvWE9iamVjdA0KL1N1YnSAwIFIvSW5mbyAxMjYgMCB"
      },
      {
        "file_name": "243.heif",
        "file_caption": "HCP2",
        "file_content_type": "image/heif",
        "format": "base64",
        "file_source_id": "1688665758000",
        "file_data": "bm5gLDJ9NC1DNFkpN20y4tLmM0JVBERi0xLjQNCjUgMCBvYmoNCjw8DQovVHlwZSAvWE9iamVjdA0KL1N1YnR5cGUgMSA"
      }
    ]
  }
}

        Sample POST data - Change request for an HCP to update primary flag on an existing address using Network vid_key, and a new address to be added to the existing HCP
      

{
    "metadata": {
    "creator": "crmuser@pharma.com",
    "note": "Update John Smith Adddress and Primary Flags",
    "source": "Veeva CRM"
  },
  "entity_type": "HCP",
  "vid_key": "Network:HCP:214065474881717253",
  "entity": {
    "addresses__v": [
      {
        "vid_key": "Network:Address:215249678634058760",
        "is_primary_address__c": true
      },
      {
        "address_line_1__v": "470 Main Street",
        "locality__v": "Huntsville",
        "ISO_3166_2__v": "US",
        "postal_code_primary__v": "35540",
        "is_primary_address__c": false
      }
    ]
  }
}

Sample POST data - Add request for an HCO with address

{
  "metadata": {
    "creator": "crmuser@pharma.com",
    "note": null,
    "source": "Veeva CRM"
  },
  "entity_type": "HCO",
  "entity": {
    "hco_type__v": "Hospital",
    "corporate_name__v": "Hospital Veeva Network",
    "specialty_1__v": "OBY",
    "specialty_2__v": "GYN",
    "count_beds__v": 500,
    "count_employees__v": 130,
    "count_medstaff__v": 70,
    "count_patients__v": 20,
    "count_locations__v": null,
    "dispense_med__v": false,
    "training_facility__v": true,
    "email_1__v": "veeva@networkhospital.com",
    "phone_1__v": "18664683400",
    "phone_2__v": "18664683401",
    "fax_1__v__v": "18664683402",
    "URL_1__v": "http://www.veevanetworkhospital.com",
    "addresses__v": [
      {
        "address_line1__v": "326 Harolds Drive",
        "building_name__v": "Sterling Building",
        "city__v": "Huntsville",
        "country__v": "US",
        "postal__v": "35806",
        "is_primary__v": true
      }
    ]
  }
}

Sample POST data - Change request to update an HCO corporate name and URL using Network vid_keys
      

{
  "metadata": {
    "creator": "crmuser@pharma.com",
    "note": "Update Hospital Name and URL",
    "source": "Veeva CRM"
  },
  "entity_type": "HCO",
  "vid_key": "Network:HCO:214065474881717253",
  "entity": {
    "corporate_name__v": "john.smith@gmail.com",
    "URL_1__v": "http://www.networkhospital.com"
  }
}

Sample POST data - Change request to update an HCO corporate name, address information, and inactivate a parentHCO using a combination of Network and Custom vid_keys
      

{
  "metadata": {
    "creator": "crmuser@pharma.com",
    "system": "CRM",
    "note": "Update Hospital Name, Address, and inactivate parent hco affiliation",
    "source": "Veeva CRM"
  },
  "entity_type": "HCO",
  "vid_key": "CRM:HCO:12345",
  "entity": {
    "corporate_name__v": "Rename Hospital",
    "addresses__v": [
      {
        "vid_key": "VCRM:Address:001A000000hTapw",
        "address_line_1__v": "100 Second Street."
      }
    ],
    "parent_hcos__v": [
      {
        "vid_key": "Network:ParentHCO:291256757999633600",
        "parent_hco_status__v": "I"
      }
    ]
  }
}

{
   "responseStatus": "SUCCESS",
   "change_request_id": 63259874100112589  
}

{
    "responseStatus": "FAILURE",
    "responseMessage": "Change requests are not supported for: EMPLOYEE__C.",
    "errors": [
        {
            "type": "UNSUPPORTED_TYPE",
            "message": "Change requests are not supported for: EMPLOYEE__C."
        }
    ],
    "errorType": "UNSUPPORTED_TYPE"
}

Cancel change request

https://DNS/api/version/change_request/change_request_id

DNS is the URL for your API service
version is the API version
change_request_id is the ID of the change request to cancel

This API takes no parameters.

Response
responseStatus: The status of the response.
change_request_id: The change request ID.

Notes

You can only delete a change request if processing has not yet started. Once a change request is being processed, a delete call results in an automatic rejection error.
If the delete call is processed successfully, the status of the change request is updated to cancelled (soft delete). Use the Retrieve Change Request API to retrieve further information on cancelled change requests.

curl DELETE -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/change_request/929455217942072479'

{
   "responseStatus": "SUCCESS",
   "change_request_id": 63259874100112589  
}

Retrieve Change Request

This API enables you to retrieve response information for the create, update, and merge change requests submitted by a client application.

Endpoint URL

https://{DNS}/api/{version}/change_requests/{change_request_ids}

DNS - is the URL for your API service
version - is the API version
change_request_ids - A comma separated list of change request IDs.

Parameters
status: Retrieve change requests of a specific status from the IDs provided.
systemName: Return target aliases specified for this system as well as the external customer keys associated to it. If a system is not provided, Network will return default reference value codes and empty external custom keys.
includeEntity: Return the full entity or entities related to the requested change requests. An entity for a change request is determined from the entity identifier (vid__v) of the change request.
sinceDate: Include change requests modified after the specified date (exclusive). This value is specified in epoch time in milliseconds.
toDate: Include change requests modified on or before the specified date (inclusive). This value is specified in epoch time in milliseconds.
includeAttachmentInfo: Include details for attachments in the change request.

Response

responseStatus

The status of the response.

change_requests

resolution_notes - An array of comments containing notes added during change request processing.

metadata - Details about the request. These details are stored in the entity history if the change is accepted.

attachments - Details for attachments in the change request.

entity - Details of the response changes, one per field, for the entity provided.

errors - Errors in retrieving the requested change requests.

parent_task_ids - List of parent task IDs.

result__v - The change request result.

status__v - The change request status.

completed_date - The completed date for the change request. If the change request is not completed, this value is empty. The date format uses the ISO8601 standard.

taskCountry - The country code of the entity.

created_date - The creation date of the change request. The date uses the ISO8601 standard.

entity_type - The entity type of the change request: HCP or HCO.

vid_key - The external HCP or HCO vid_key supplied by the client in the original change request.

original_task_type - The original change request type.

change_request_id - The change request ID.

vid__v - The ID of the entity: HCP or HCO.

task_type - The final change request type as an add request. Could become a change request.

Field results
CHANGE_ACCEPTED: The change for this field has been accepted.
CHANGE_REJECTED: The change for this field has been rejected.
CHANGE_MODIFIED: The change for this field has been accepted with differences .
CHANGE_ALREADYAPPLIED: The change for this field has already been applied.
CHANGE_ADDED: The change for this field was added to the change request after creation.

Child object attributes
vid_key: The external vid_key supplied by the client in the original change request.
vid__v: The Veeva ID of the entity.
field: The Network API name of the entity's field for the HCP or HCO.

change_requested - The value of the requested change.

final_value - The new value of the field.

result -
CHANGE_ACCEPTED - The change for this field has been accepted.
CHANGE_REJECTED - The change for this field has been rejected.
CHANGE_MODIFIED - The change for this field has been accepted with differences .
CHANGE_ALREADYAPPLIED - The change for this field has already been applied.
CHANGE_ADDED - The change for this field was added to the change request after creation.

Notes

Addresses, licenses, and parent HCOs are an array of fields within themselves. There could be multiple addresses or licenses responses for the same HCP or HCO matching the change request submitted originally.
The overall result of the change request will be null until all the changes requested are reviewed and the status is PROCESSED or CANCELLED.

Changelog

The object_id__v field is supported in Network v4.0 and later.

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/change_requests/929455217942072479'

{
   "change_requests" : [
      {
         "created_date" : "2016-12-08T13:59:22.000-08:00",
         "original_task_type" : "ADD_REQUEST",
         "entity" : {
            "kaiser__v" : {
               "change_requested" : "N",
               "result" : null,
               "final_value" : null
            },
            "pdrp_optout__v" : {
               "final_value" : null,
               "result" : null,
               "change_requested" : "N"
            },
            "fellow__v" : {
               "final_value" : null,
               "change_requested" : "N",
               "result" : null
            },
            "first_name__v" : {
               "result" : "CHANGE_ACCEPTED",
               "change_requested" : "Tim",
               "final_value" : "Tim"
            },
            "last_name__v" : {
               "change_requested" : "Othy",
               "result" : null,
               "final_value" : null
            },
            "primary_country__v" : {
               "final_value" : null,
               "result" : null,
               "change_requested" : "US"
            },
            "hcp_status__v" : {
               "change_requested" : "A",
               "result" : null,
               "final_value" : null
            },
            "grad_training__v" : {
               "change_requested" : "N",
               "result" : null,
               "final_value" : null
            },
            "custype__c" : {
               "final_value" : null,
               "result" : null,
               "change_requested" : "4:37"
            },
            "ama_do_not_contact__v" : {
               "final_value" : null,
               "change_requested" : "N",
               "result" : null
            },
            "hcp_type__v" : {
               "final_value" : null,
               "change_requested" : "P",
               "result" : null
            },
            "testtesttest__c" : {
               "change_requested" : "False",
               "result" : null,
               "final_value" : null
            }
         },
         "status__v" : "CHANGE_PARTIALLYPROCESSED",
         "vid__v" : "929455217958715423",
         "reserved_vid" : null,
         "change_request_id" : "929455217942072479",
         "entity_type" : "HCP",
         "metadata" : {
            "system" : null,
            "source" : "Entity Profile Editor",
            "creator" : "john.smith@my.veevanetwork.com",
            "note" : "New record added via Network portal."
		 }，
         "attachments": [
            {
               "file_name": "196.heif",
               "file_caption": "HCP1",
               "file_content_type": "image/heif",
               "file_source_id": "1688665744000",
               "file_status": "SUCCESS",
               "name": "943805201003187359",
               "file_size": 2593013,
               "timestamp": 1700190526000,
               "can_send_attachment_to_opendata": true
            },
            {
               "file_name": "243.heif",
               "file caption": "HCP2",
               "file_content_type": "image/heif",
               "file_source_id": "1688665758000",
               "file status": "SUCCESS",
               "name": "943805201006660767",
               "file_size": 2465548,
               "timestamp": 1700190526000,
               "can_send_attachment_to_opendata": true
            }
         ],
         "result__v" : null,
         "parent_task_ids" : [],
         "taskCountry" : "US",
         "vid_key" : null,
         "task_type" : "ADD_REQUEST",
         "resolution_notes" : [
            {
               "comment" : "fas",
               "created_date" : "2016-12-19T07:46:39.766-08:00",
               "code" : null,
               "fields" : [
                  "kaiser__v",
                  "hcp_type__v",
                  "last_name__v",
                  "hcp_status__v",
                  "pdrp_optout__v",
                  "primary_country__v",
                  "fellow__v",
                  "grad_training__v",
                  "ama_do_not_contact__v",
                  "first_name__v"
               ]
            }
         ],
         "completed_date" : null
      }
   ],
   "responseStatus" : "SUCCESS"
		}

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/change_requests/544408527049851904,544411763097994240?status=CHANGE_PROCESSED&status=CHANGE_CANCELLED'

Batch retrieve change request

This API enables you to obtain information about multiple change requests through the API.

Endpoint URL

https://DNS/api/version/change_requests/batch

DNS - is the URL for your API service
version - is the API version

This API takes no parameters.

POST data
change_requests: An array of change request IDs.

change_request_id - The ID of the change request generated in Network.
systemName: Return target aliases specified for this system as well as the external customer keys associated to it. If a system is not provided, Network will return default reference value codes and empty external custom keys.
status_codes: A list of status codes.

CHANGE_NEW - The change request has been received but not run yet.

CHANGE_PENDINGREVIEW - The change request was received and processed but is pending review by data stewards or another upstream source.

CHANGE_INQUEUE - The change request is made on an unverified object and is pending parent task processing.

CHANGE_PARTIALLYPROCESSED - The change request was partially processed by master or customer data stewards.

CHANGE_PROCESSED - The change request was processed and a result issued.

CHANGE_CANCELLED - The change request was cancelled.
includeEntity: Return the full entity or entities related to the requested change requests. An entity for a change request is determined from the entity identifier (vid__v) of the change request.
sinceDate: Include change requests modified after the specified date (exclusive). This value is specified in epoch time in milliseconds.
toDate: Include change requests modified on or before the specified date (inclusive). This value is specified in epoch time in milliseconds.
includeAttachmentInfo: Include details for attachments in the change request.

Response

responseStatus

The status of the response.

change_requests

metadata - Details about the request. These details are stored in the entity history if the change is accepted.

attachments - Details for attachments in the change request.

entity - Details of the response changes, one per field, for the entity provided.

errors - Errors in retrieving the requested change requests.

parent_task_ids - List of parent task IDs.

result__v - The change request result.

status__v - The change request status.

completed_date - The completed date for the change request. If the change request is not completed, this value is empty. The date format uses the ISO8601 standard.

taskCountry - The country code of the entity.

created_date - The creation date of the change request. The date uses the ISO8601 standard.

entity_type - The entity type of the change request: HCP or HCO.

vid_key - The external HCP or HCO vid_key supplied by the client in the original change request.

original_task_type - The original change request type.

change_request_id - The change request ID.

vid__v - The ID of the entity: HCP or HCO.

task_type - The final change request type as an add request. Could become a change request.

entities

An array of entities associated with the change requests. Each entity is related to a change request through the vid__v field.

Field results
CHANGE_ACCEPTED: The change for this field has been accepted.
CHANGE_REJECTED: The change for this field has been rejected.
CHANGE_MODIFIED: The change for this field has been accepted with differences .
CHANGE_ALREADYAPPLIED: The change for this field has already been applied.
CHANGE_ADDED: The change for this field was added to the change request after creation.

Child object attributes
vid_key: The external vid_key supplied by the client in the original change request.
vid__v: The Veeva ID of the entity.
field: The Network API name of the entity's field for the HCP or HCO.

change_requested - The value of the requested change.

final_value - The new value of the field.

result -
CHANGE_ACCEPTED - The change for this field has been accepted.
CHANGE_REJECTED - The change for this field has been rejected.
CHANGE_MODIFIED - The change for this field has been accepted with differences .
CHANGE_ALREADYAPPLIED - The change for this field has already been applied.
CHANGE_ADDED - The change for this field was added to the change request after creation.

Changelog

Version 5.0 added the CHANGE_ADDED result for fields added after DCR creation.
Version 6.0 included errors in the response for change requests that are not found.
Version 7.0 added master_keys, external_custom_keys (when systemName provided, task_type, and original_task_type for easier downstream integration.
Version 8.0 added a parameter to include related entities in the response.
Version 10.0 added parent_task_ids for change requests, and introduced the CHANGE_INQUEUE status (status__v).

curl -i -H "Authorization: 57696C6C205261...6368204C6F7368" -H "Content-type: application/json" -X POST -d "@dcrs_postdata.json" 'https://my.veevanetwork.com/api/v33.0change_requests/batch'

{
  "change_requests":[
   {
    "change_request_id":"527723033129911296"
   },
   {
    "change_request_id":"493664636982264832"
   }
  ]
}{
  "change_requests":[
   {
    "change_request_id":"441305647707849728"
   },
   {
    "change_request_id":"441306106715702272"
   }
  ],
  "status_codes":[
    "CHANGE_NEW",
    "CHANGE_PENDINGREVIEW"
  ]
}

{
  "responseStatus": "SUCCESS",
  "change_requests": [
    {
      "metadata": {
        "creator": "john.smith@my.veevanetwork.com",
        "note": "Customer Master changes applied",
        "source": "Entity Profile Editor",
        "system": "ERP1"
      },
      "entity": {
        "specialty_2__v": {
          "change_requested": "MT",
          "final_value": null,
          "result": "CHANGE_REJECTED"
        },
        "external_custom_keys": [
          "ERP1:HCP:654321"
        ]
      },
      "taskCountry": "US",
      "task_type": "CHANGE_REQUEST",
      "original_task_type": "CHANGE_REQUEST",
      "change_request_id": "493664636982264832",
      "status__v": "CHANGE_PROCESSED",
      "result__v": "CHANGE_REJECTED",
      "entity_type": "HCP",
      "vid_key": "Network:Entity:462463289150931969",
      "vid__v": "462463289150931969",
      "resolution_notes": [
        {
          "comment": "System Rejected - Can't update an INVALID/MERGED-INTO record",
          "fields": [
            "specialty_2__v"
          ],
          "created_date": "2014-12-15T17:20:09.620-06:00",
          "code": "R-10001"
        }
      ],
      "created_date": "2014-10-08T16:38:47.000-05:00",
      "completed_date": "2014-12-15T17:20:11.000-06:00"
    },
    {
      "metadata": {
        "creator": "john.smith@my.veevanetwork.com",
        "note": "Customer Master changes applied",
        "source": "Entity Profile Editor",
        "system": null
      },
      "entity": {
        "external_custom_keys": [
          "ERP1:HCP:987654"
        ],
        "parent_hcos__v": [
          {
            "vid_key": "Network:ParentHCO:477715384619762691",
            "vid__v": "477715384619762691",
            "object_id": "527723032584651776",
            "is_primary_relationship__v": {
              "change_requested": "N",
              "final_value": null,
              "result": null
            },
            "external_custom_keys": [
              "ERP1:PARENTHCO:123456"
            ]
          }
        ]
      },
      "taskCountry": "US",
      "task_type": "CHANGE_REQUEST",
      "original_task_type": "CHANGE_REQUEST",
      "change_request_id": "527723033129911296",
      "status__v": "CHANGE_PENDINGREVIEW",
      "result__v": null,
      "entity_type": "HCP",
      "vid_key": "Network:Entity:469466290176656385",
      "vid__v": "469466290176656385",
      "resolution_notes": null,
      "created_date": "2014-11-24T15:26:44.000-06:00",
      "completed_date": null
    }
  ]
}

{
  "change_requests":[
   {
    "change_request_id":"441305647707849728"
   },
   {
    "change_request_id":"441306106715702272"
   }
  ],
  "systemName":"ODS"
		}

{
  "responseStatus": "SUCCESS",
  "change_requests": [
    {
      "metadata": {
        "creator": "fName.lName@sandbox.veevanetwork.com",
        "note": "Customer Master changes applied",
        "source": "Entity Profile Editor",
        "system": "ERP1"
      },
      "entity": {
        "specialty_2__v": {
          "change_requested": "MT",
          "final_value": null,
          "result": "CHANGE_REJECTED"
        },
        "external_custom_keys": [
          "ERP1:HCP:654321"
        ]
      },
      "taskCountry": "US",
      "task_type": "CHANGE_REQUEST",
      "original_task_type": "CHANGE_REQUEST",
      "change_request_id": "493664636982264832",
      "status__v": "CHANGE_PROCESSED",
      "result__v": "CHANGE_REJECTED",
      "entity_type": "HCP",
      "vid_key": "Network:Entity:462463289150931969",
      "vid__v": "462463289150931969",
      "resolution_notes": [
        {
          "comment": "System Rejected - Can't update an INVALID/MERGED-INTO record",
          "fields": [
            "specialty_2__v"
          ],
          "created_date": "2014-12-15T17:20:09.620-06:00",
		  "code": "R-10001"
        }
      ],
      "created_date": "2014-10-08T16:38:47.000-05:00",
      "completed_date": "2014-12-15T17:20:11.000-06:00"
    },
    {
      "metadata": {
        "creator": "fName.lName@sandbox.veevanetwork.com",
        "note": "Customer Master changes applied",
        "source": "Entity Profile Editor",
        "system": null
      },
      "entity": {
        "external_custom_keys": [
          "ERP1:HCP:987654"
        ],
        "parent_hcos__v": [
          {
            "vid_key": "Network:ParentHCO:477715384619762691",
            "vid__v": "477715384619762691",
            "object_id": "527723032584651776",
            "is_primary_relationship__v": {
              "change_requested": "N",
              "final_value": null,
              "result": null
            },
            "external_custom_keys": [
              "ERP1:PARENTHCO:123456"
            ]
          }
        ]
      },
      "taskCountry": "US",
      "task_type": "CHANGE_REQUEST",
      "original_task_type": "CHANGE_REQUEST",
      "change_request_id": "527723033129911296",
      "status__v": "CHANGE_PENDINGREVIEW",
      "result__v": null,
      "entity_type": "HCP",
      "vid_key": "Network:Entity:469466290176656385",
      "vid__v": "469466290176656385",
      "resolution_notes": null,
      "created_date": "2014-11-24T15:26:44.000-06:00",
      "completed_date": null
    }
  ]
}

Update Change Request

This API enables you to update an unprocessed change request.

Endpoint URL

https://DNS/api/version/change_request

DNS - is the URL for your API service
version - is the API version

PUT Data
system: The name of a valid system in Network.
result: The result of the update:
CHANGE_ACCEPTED - All changes for this request have been accepted.
CHANGE_REJECTED - No changes for this request were accepted.
CHANGE_MODIFIED - The change for this field has been accepted with differences.
CHANGE_ALREADYAPPLIED - The change for this field has already been applied .
master_keys: This parameter is only required if you are updating a change request from a third-party master. It is an array of external keys to identify the entity and each of the child objects (addresses, licenses, parent HCOs). The key format is the three-part format used by vid_key, consisting of source type (typically the name of the system used to load the master data), item type, and value, separated by colons. The master keys are essential to link the entity and child objects in the change request to the entity loaded through a subscription job.
taskCountry: The country code of the change request.
change_request_id: The ID of the change request generated in Network.
job_ids: A list of IDs of source subscription jobs used to load the entity in this change request. Upon processing, the final values of the fields of the entity will be obtained from the entity loaded through jobs.
comment: A comment about the feedback related to the change request update. The comment will be transfer to the resolution notes after each update.

Response
responseStatus: The status of the response.
change_requests: The response status confirming the success of the operation.

The change request ID.
errors: A detailed message for the error type. This message is subject to change and is not contractual for error handling.

The error type.

Notes

Not all fields in the change requests can be updated by the integrator system; however, those fields can be provided during the update and Network will ignore them.

curl -i -H "Authorization: 57696C6C205261...6368204C6F7368" -H "Content-type: application/json" -X PUT -d "@dcrs_postdata.json" 'https://my.veevanetwork.com/api/v33.0/change_request'

{
  "metadata": {
    "creator": "john.smith@my.veevanetwork.com",
    "note": "New record added via API.",
    "system": "ERP1"
  },
  "entity": {
    "hcp_type__v": {
      "change_requested": "P",
      "final_value": null,
      "result": "CHANGE_ACCEPTED"
    },
    "first_name__v": {
      "change_requested": "Charlie",
      "final_value": null,
      "result": "CHANGE_ACCEPTED"
    },
    "last_name__v": {
      "change_requested": "Brown",
      "final_value": null,
      "result": "CHANGE_ACCEPTED"
    },
    "hcp_status__v": {
      "change_requested": "A",
      "final_value": null,
      "result": "CHANGE_ACCEPTED"
    },
    "medical_degree_1__v": {
      "change_requested": "MD",
      "final_value": null,
      "result": "CHANGE_ACCEPTED"
    },
    "specialty_1__v": {
      "change_requested": "IM",
      "final_value": null,
      "result": "CHANGE_ACCEPTED"
    },
    "primary_country__v": {
      "change_requested": "US",
      "final_value": null,
      "result": "CHANGE_ACCEPTED"
    },
    "gender__v": {
      "change_requested": "M",
      "final_value": null,
      "result": "CHANGE_ACCEPTED"
    },
    "master_keys": [
      "master_source:HCP:997200002"
    ]
  },
  "taskCountry": "US",
  "task_type": "CHANGE_REQUEST",
  "original_task_type": "CHANGE_REQUEST",
  "change_request_id": "542116772438868992",
  "status__v": "CHANGE_NEW",
  "result__v": "CHANGE_PENDING",
  "entity_type": "HCP",
  "vid_key": null,
  "vid__v": null,
  "resolution_notes": null,
  "created_date": "2014-10-08T09:54:55.000-04:00",
  "completed_date": null,
  "job_ids": [
    "486"
  ],
  "comment": "All fields updated through load"
}

{
    "responseStatus": "SUCCESS",
    "change_requests": [
        {
            "responseStatus": "SUCCESS",
            "change_request_id": "542116772438868992"
        }
    ]
}

Batch Update Change Requests

This API enables you to update multiple unprocessed change requests.

Endpoint URL

https://DNS/api/version/change_request/batch

DNS - is the URL for your API service
version - is the API version

PUT Data
system: The name of a valid system in Network.
result: The result of the update:
CHANGE_ACCEPTED - All changes for this request have been accepted.
CHANGE_REJECTED - No changes for this request were accepted.
CHANGE_MODIFIED - The change for this field has been accepted with differences.
CHANGE_ALREADYAPPLIED - The change for this field has already been applied .
master_keys: This parameter is only required if you are updating a change request from a third-party master. It is an array of external keys to identify the entity and each of the child objects (addresses, licenses, parent HCOs). The key format is the three-part format used by vid_key, consisting of source type (typically the name of the system used to load the master data), item type, and value, separated by colons. The master keys are essential to link the entity and child objects in the change request to the entity loaded through a subscription job.
taskCountry: The country code of the change request.
change_request_id: The ID of the change request generated in Network.
job_ids: A list of IDs of source subscription jobs used to load the entity in this change request. Upon processing, the final values of the fields of the entity will be obtained from the entity loaded through jobs.
comment: A comment about the feedback related to the change request update. The comment will be transfer to the resolution notes after each update.

Response
responseStatus: The status of the response.
change_requests: The response status confirming the success of the operation.

The change request ID.
errors: A detailed message for the error type. This message is subject to change and is not contractual for error handling.

The error type.

curl -i -H "Authorization: 57696C6C205261...6368204C6F7368" -H "Content-type: application/json" -X PUT -d "@dcrs_postdata.json" 'https://my.veevanetwork.com/api/v33.0/change_request/batch'

{
  "change_requests": [
    {
      "metadata": {
        "creator": "john.smith@my.veevanetwork.com",
        "note": "New record added via API.",
        "system": "ERP1"
      },
      "entity": {
        "hcp_type__v": {
          "change_requested": "P",
          "final_value": null,
          "result": "CHANGE_ACCEPTED"
        },
        "first_name__v": {
          "change_requested": "Marvin",
          "final_value": null,
          "result": "CHANGE_ACCEPTED"
        },
        "last_name__v": {
          "change_requested": "Gaye",
          "final_value": null,
          "result": "CHANGE_ACCEPTED"
        },
        "hcp_status__v": {
          "change_requested": "A",
          "final_value": null,
          "result": "CHANGE_ACCEPTED"
        },
        "medical_degree_1__v": {
          "change_requested": "MD",
          "final_value": null,
          "result": "CHANGE_ACCEPTED"
        },
        "specialty_1__v": {
          "change_requested": "IM",
          "final_value": null,
          "result": "CHANGE_ACCEPTED"
        },
        "primary_country__v": {
          "change_requested": "US",
          "final_value": null,
          "result": "CHANGE_ACCEPTED"
        },
        "gender__v": {
          "change_requested": "M",
          "final_value": null,
          "result": "CHANGE_ACCEPTED"
        },
        "master_keys": [
          "master_source:HCP:997200012"
        ]
      },
      "taskCountry": "US",
      "change_request_id": "543667922896159744",
      "status__v": "CHANGE_PARTIALLYPROCESSED",
      "result__v": null,
      "entity_type": "HCP",
      "vid_key": null,
      "vid__v": null,
      "resolution_notes": null,
      "created_date": "2014-11-06T08:49:33.000-05:00",
      "completed_date": null,
      "job_ids": [
        "504"
      ],
      "comment": "All fields updated through master data load"
    },
    {
      "metadata": {
        "creator": "john.smith@my.veevanetwork.com",
        "note": "New record added via API.",
        "source": "API"
      },
      "entity": {
        "hcp_type__v": {
          "change_requested": "P",
          "final_value": null,
          "result": "CHANGE_ACCEPTED"
        },
        "first_name__v": {
          "change_requested": "Nigella",
          "final_value": null,
          "result": "CHANGE_ACCEPTED"
        },
        "last_name__v": {
          "change_requested": "Lam",
          "final_value": null,
          "result": "CHANGE_ACCEPTED"
        },
        "hcp_status__v": {
          "change_requested": "A",
          "final_value": null,
          "result": "CHANGE_ACCEPTED"
        },
        "medical_degree_1__v": {
          "change_requested": "MD",
          "final_value": null,
          "result": "CHANGE_ACCEPTED"
        },
        "specialty_1__v": {
          "change_requested": "IM",
          "final_value": null,
          "result": "CHANGE_ACCEPTED"
        },
        "primary_country__v": {
          "change_requested": "US",
          "final_value": null,
          "result": "CHANGE_ACCEPTED"
        },
        "gender__v": {
          "change_requested": "M",
          "final_value": null,
          "result": "CHANGE_ACCEPTED"
        },
        "master_keys": [
          "master_source:HCP:997200013"
        ]
      },
      "taskCountry": "US",
      "change_request_id": "542116772438868992",
      "status__v": "CHANGE_PARTIALLYPROCESSED",
      "result__v": null,
      "entity_type": "HCP",
      "vid_key": null,
      "vid__v": null,
      "resolution_notes": null,
      "created_date": "2014-11-06T08:49:33.000-05:00",
      "completed_date": null,
      "job_ids": [
        "504"
      ],
      "comment": "All fields updated through master data load"
    }
  ]
}

{
    "responseStatus": "SUCCESS",
    "change_requests": [
        {
            "responseStatus": "SUCCESS",
            "change_request_id": "543667922896159744"
        },
        {
            "responseStatus": "SUCCESS",
            "change_request_id": "542116772438868992"
        }
    ]
}

Process Change Request

This API enables you to process an unprocessed change request through the API.

Endpoint URL

https://DNS/api/version/change_request/process/change_request_id

DNS - is the URL for your API service
version - is the API version
change_request_id - The ID of the change request.

Parameters
change_request_id: The ID of the change request generated in Network.
systemName: Return target aliases specified for this system as well as the external customer keys associated to it. If a system is not provided, Network will return default reference value codes and empty external custom keys.

Response
responseStatus: The status of the response.

curl -X PUT -H "Content-Type: application/json" -d '{}' -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/change_request/process/935201059206140415'

{
  "responseStatus": "SUCCESS"
}

Batch Process Change Requests

This API enables you to process multiple unprocessed change requests.

Endpoint URL

https://DNS/api/version/change_request/process/batch

DNS - is the URL for your API service
version - is the API version

PUT Data

change_requests

An array of change request IDs.

change_request_id - The ID of the change request generated in Network.

systemName

Return target aliases specified for this system as well as the external customer keys associated to it. If a system is not provided, Network will return default reference value codes and empty external custom keys.

Response
responseStatus: The status of the response.

curl -i -H "Authorization: 57696C6C205261...6368204C6F7368" -H "Content-type: application/json" -X PUT -d "@dcrs_postdata.json" 'https://my.veevanetwork.com/api/v33.0/change_request/process/batch'

{
  "change_requests": [
    {
      "change_request_id": "543667922896159744"
    },
    {
      "change_request_id": "542116772438868992"
    }
  ],
  "systemName": "ERP1"
}

{
    "responseStatus": "SUCCESS"
}

Batch Reject Change Requests

This API enables you to bulk reject up to 500 change requests.

Endpoint URL

https://DNS/api/version/change_request/reject/batch

DNS - is the URL for your API service
version - is the API version

PUT Data
change_requests: An array of change request IDs.

change_request_id - The ID of the change request generated in Network.

code - A custom resolution code to add to the resolution notes.

comment - A comment to add to the resolution notes.
systemName: Return target aliases specified for this system as well as the external customer keys associated to it. If a system is not provided, Network will return default reference value codes and empty external custom keys.

Response
responseStatus: The status of the response.

Notes

Only change requests that are pending review can be rejected in batch.

curl -i -H "Authorization: 57696C6C205261...6368204C6F7368" -H "Content-type: application/json" -X PUT -d "@dcrs_postdata.json" 'https://my.veevanetwork.com/api/v33.0/change_request/reject/batch'

{
  "change_requests": [
    {
      "change_request_id": "543667922896159744"
    },
    {
      "change_request_id": "542116772438868992",
      "comment": "This comment overwrites the resolution notes template.",
      "code": "R-00010"
    }
  ],
  "systemName": "ERP1"
}

{
    "responseStatus": "SUCCESS"
}

Batch Approve Change Requests

This API enables you to bulk approve up to 500 change requests.

Endpoint URL

https://DNS/api/version/change_request/approve/batch

DNS - is the URL for your API service
version - is the API version

PUT Data
change_requests: An array of change request IDs.

change_request_id - The ID of the change request generated in Network.

code - A custom resolution code to add to the resolution notes.

comment - A comment to add to the resolution notes.
systemName: Return target aliases specified for this system as well as the external customer keys associated to it. If a system is not provided, Network will return default reference value codes and empty external custom keys.

Response
responseStatus: The status of the response.

curl -i -H "Authorization: 57696C6C205261...6368204C6F7368" -H "Content-type: application/json" -X PUT -d "@dcrs_postdata.json" 'https://my.veevanetwork.com/api/v33.0/change_request/approve/batch'

{
  "change_requests": [
    {
      "change_request_id": "543667922896159744"
    },
    {
      "change_request_id": "542116772438868992",
      "comment": "This comment overwrites the resolution notes template.",
      "code": "R-00010"
    }
  ],
  "systemName": "ERP1"
}

{
    "responseStatus": "SUCCESS"
}

Change Request Search

This API enables you to retrieve all change requests that match a specified search criteria.

Endpoint URL

https://{DNS}/api/{version}/change_request/search

DNS - is the URL for your API service
version - is the API version

Parameters
q: The text for the search query. Uses the following fields:

subject

description

summary

task_type

task_data

comment
offset: The first record to retrieve from the offset specified. The default value is 0.
limit: The number to limit the results returned. The default is 10; the maximum is 100.
sort: The attribute to sort results by; for example, task_type .
sortOrder: The sort order: asc for ascending or desc for descending.
filters: Filters for refining the results.. See the Search Filters table for more information.
systemName: When provided, Network returns target alias values defined for reference codes for this system. Otherwise, Network returns default reference code values.
masterSystemNames: A comma-separated list of master system names. Search results will include only change requests that are handled by the specified master systems. Includes all pending and processed change requests.
pendingMasterSystemNames: A comma-separated list of master system names. Search results will include only change requests that are awaiting processing by the specified master systems.

Search filters
task_type: The change request type.

ADD_REQUEST - An add request submitted on an existing record in Network.

CHANGE_REQUEST - A change request for a new record in Network.
task_status: The status of the task.

NEW - A new task has been received but not run yet.

IN_PROGRESS - A task is pending approval by a master or customer master data steward.

CLOSED - A task has been closed.
task_country: The country to which the task belongs.
task_state: The state of the task.

NEW - A new task has been received but not run yet.

PENDINGREVIEW - A task was received and processed but is pending review by data stewards or another upstream source.

CANCELLED - The task was cancelled.

FAILED - The task failed due to an unexpected error.

PROCESSED - The task was processed and a result issued.

PROCESSING - The task is being processed.
resolution: The resolution for the task.

CHANGE_PENDING - All changes for this request are pending approval.

CHANGE_ACCEPTED - All changes for this request have been accepted.

CHANGE_REJECTED - All changes for this request were rejected.

CHANGE_PARTIAL - At least one field change was accepted.
created_at: The date the task was created .
created_by: The ID of the user that generated the change request.
creator: The user name of the user that generated the change request.
completed_at: The completed date of the task. Is empty if the change request is not completed. Date format is ISO8601 standard.
completed_by: The ID of the user that approved the task.
open: The task is open: True or False.
system: The name of the system that generated the task. This is used for reference aliases and other validation.
entity_type: The entity type for the task: HCP or HCO.
entity_id: The Veeva Network entity ID.
owner: The ID of the owner of the task.

Filter values passed in from a GET request need to be URL-encoded.

Response

responseStatus

The status of the response.

totalCount

The total number of search results, regardless of the set limit.

offset

The first record to retrieve from the offset specified. The default value is 0.

limit

The number provided to limit the search results.

change_requests

metadata - Details about the request. These details are stored in the entity history if the change is accepted.

entity - Details of the response changes, one per field, for the entity provided.

taskCountry - The country code of the entity.

task_type - The final change request type as an add request. Could become a change request.

original_task_type - The original change request type.

change_request_id - The change request ID.

status__v - The change request status.

result__v - The change request result.

entity_type - The entity type of the change request: HCP or HCO.

vid_key - The external HCP or HCO vid_key supplied by the client in the original change request.

resolution_notes - An array of comments containing notes added during change request processing.

created_date - The creation date of the change request. The date uses the ISO8601 standard.

completed_date - The completed date for the change request. If the change request is not completed, this value is empty. The date format uses the ISO8601 standard.

errors - Errors in retrieving the requested change requests.

Field results
CHANGE_ACCEPTED: The change for this field has been accepted.
CHANGE_REJECTED: The change for this field has been rejected.
CHANGE_MODIFIED: The change for this field has been accepted with differences .
CHANGE_ALREADYAPPLIED: The change for this field has already been applied.
CHANGE_ADDED: The change for this field was added to the change request after creation.

Child object attributes
vid_key: The external vid_key supplied by the client in the original change request.
vid__v: The Veeva ID of the entity.
field: The Network API name of the entity's field for the HCP or HCO.

change_requested - The value of the requested change.

final_value - The new value of the field.

result -
CHANGE_ACCEPTED - The change for this field has been accepted.
CHANGE_REJECTED - The change for this field has been rejected.
CHANGE_MODIFIED - The change for this field has been accepted with differences .
CHANGE_ALREADYAPPLIED - The change for this field has already been applied.
CHANGE_ADDED - The change for this field was added to the change request after creation.

Changelog

Version 7.0 responses included master_keys, external_custom_keys (if systemName provided), task_type, and original_task_type for easier downstream integration.

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/change_request/search?offset=0&filters=task_status:NEW~task_country:US'

{
   "offset" : 0,
   "change_requests" : [
      {
         "vid__v" : "242979820290442251",
         "entity_type" : "HCP",
         "completed_date" : null,
         "status__v" : "CHANGE_PENDINGREVIEW",
         "taskCountry" : "US",
         "change_request_id" : "928804073117519007",
         "vid_key" : "Network:Entity:242979820290442251",
         "reserved_vid" : null,
         "metadata" : {
            "note" : "Customer Master changes applied",
            "system" : null,
            "creator" : "john.smith@my.veevanetwork.com",
            "source" : "Entity Profile Editor"
         },
         "parent_task_ids" : [],
         "created_date" : "2016-08-15T15:04:40.000-07:00",
         "entity" : {
            "specialty_1__v" : {
               "final_value" : null,
               "result" : null,
               "change_requested" : "UCM"
            }
         },
         "result__v" : null,
         "original_task_type" : "CHANGE_REQUEST",
         "task_type" : "CHANGE_REQUEST",
         "resolution_notes" : null
      },
      {
         "parent_task_ids" : [],
         "metadata" : {
            "source" : "Entity Profile Editor",
            "creator" : "john.smith@my.veevanetwork.com",
            "system" : null,
            "note" : "address update. he no longer works there"
         },
         "created_date" : "2016-08-22T10:00:17.000-07:00",
         "original_task_type" : "CHANGE_REQUEST",
         "result__v" : null,
         "entity" : {
            "addresses__v" : [
               {
                  "postal_code__v" : {
                     "result" : null,
                     "change_requested" : "15243-1317",
                     "final_value" : null
                  },
                  "object_id" : "928842512290483360",
                  "country__v" : {
                     "final_value" : null,
                     "result" : null,
                     "change_requested" : "US"
                  },
                  "vid_key" : "Network:Address:243244004181804041",
                  "locality__v" : {
                     "final_value" : null,
                     "change_requested" : "Pittsburgh",
                     "result" : null
                  },
                  "vid__v" : "243244004181804041",
                  "address_line_3__v" : {
                     "final_value" : null,
                     "result" : null,
                     "change_requested" : null
                  },
                  "administrative_area__v" : {
                     "change_requested" : "US-PA",
                     "result" : null,
                     "final_value" : null
                  },
                  "address_line_2__v" : {
                     "change_requested" : null,
                     "result" : null,
                     "final_value" : null
                  },
                  "address_line_1__v" : {
                     "final_value" : null,
                     "change_requested" : "277 Dupont Cir",
                     "result" : null
                  }
               }
            ]
         },
         "resolution_notes" : null,
         "task_type" : "CHANGE_REQUEST",
         "entity_type" : "HCP",
         "vid__v" : "242979820290442251",
         "change_request_id" : "928842512431123615",
         "vid_key" : "Network:Entity:242979820290442251",
         "taskCountry" : "US",
         "status__v" : "CHANGE_PENDINGREVIEW",
         "completed_date" : null,
         "reserved_vid" : null
      }
   ],
   "totalCount" : 268,
   "responseStatus" : "SUCCESS",
   "limit" : 2
}

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/change_request/search?filters=range||created_at:1403531171000||1406123171000'

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/change_request/search?filters=range||created_at:1403531171000'

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/change_request/search?rangeDiff||created_at:||48'

Change Request Match

This API enables you to match a request to an existing entity. You can use either the Veeva ID or custom key of an existing entity to match the request against.

Endpoint URL

https://dns/api/version/change_request/match/change_request_id

DNS - is the URL for your API service
version - is the API version
change_request_id - The ID of the change request.

Parameters
vidKey: The key for the object.
comment: Notes added by the Network user.

Response
responseStatus: The status of the response.
change_request_id: The ID of the change request.

Notes

responseStatus returns a failure if any standard errors occur or:
vid_key does not represent an existing entity.
The entity represented by vid_key is not in the VALID state.
The change_request_id does not represent an existing request.
The type of entity (for example, HCP) doesn't match with the type of the request (for example, HCO).

curl -X POST -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/change_request/match/542116772438868992?vidKey=847328898944336896'

{
  "responseStatus": "SUCCESS",
  "change_request_id": 542116772438868992
}

Batch Process Suspect Match

This API enables enables you to process multiple unprocessed suspect matches.

Endpoint URL

https://dns/api/version/suspect-match/process/batch

DNS - is the URL for your API service
version - is the API version

This API takes no parameters.

PUT Data
task_id: The ID of a suspect match to process.
match_entities: The pairs of entities to match. Leave empty to reject the suspect match.
source_entity_id: The ID of the entity to be merged.
target_entity_id: The ID of the entity that the match will be merged into.
comment: The resolution note to apply.

Response
responseStatus: The status of the response.
suspect_matches: An array of suspect_matches that correspond to the same objects in the request.

The status of a processed suspect match.

The ID of a processed suspect match.

Notes

vid_key does not represent an existing entity.
The entity represented by vid_key is not in the VALID state.
The change_request_id does not represent an existing request.
The type of entity (for example, HCP) doesn't match with the type of the request (for example, HCO).

curl -i -H "Authorization: 57696C6C205261...6368204C6F7368" -H "Content-type: application/json" -X PUT -d "@match_postdata.json" 'https://my.veevanetwork.com/api/v33.0/suspect-match/process/batch'

{
   "suspect_matches":[
      {
         "task_id":"929058362287521823",
         "comment":"Rejected suspect match"
      }
   ]
}

{
   "responseStatus": "SUCCESS",
   "suspect_matches": [
      {
         "responseStatus": "SUCCESS",
         "task_id": "929058346986962975"
      }
   ]
}

{
   "suspect_matches":[
      {
         "task_id":"929058346986962975",
         "comment":"Accepted suspect match",
         "match_entities":[
            {
               "source_entity_id":"928729167160023840",
               "target_entity_id":"928729206350945055"
            }
         ]
      }
   ]
}

Batch Create Suspect Match

This API enables enables you to create multiple suspect matches.

Endpoint URL

https://dns/api/version/entity/createSuspectMatch/batch

DNS - is the URL for your API service
version - is the API version

This API takes no parameters.

POST Data
vid_key: The vid_key of the entity to be merged.
matching_vid_key: The vid_key of the entity to match.
metadata: Details about the request. These details are stored in the entity history if the change is accepted.

creator - The name of the user that generated the request.

note - Details about the request.

source - Additional information about the source of the request.

Response
responseStatus: The status of the response.
suspect_matches: An array of suspect_matches that correspond to the same objects in the request.

The ID of a processed suspect match.

Notes

vid_key does not represent an existing entity.
The entity represented by vid_key is not in the VALID state.
The type of entity (for example, HCP) doesn’t match with the type of the request (for example, HCO).

curl -i -H "Authorization: 57696C6C205261...6368204C6F7368" -H "Content-type: application/json" -X POST -d "@matches_postdata.json" 'https://my.veevanetwork.com/api/v33.0/entity/createSuspectMatch/batch'

{
    "suspect_matches": [{
            "metadata": {
                "note": "",
                "creator": "John Smith"
            },
            "vid_key": "Network:Entity:242980101568857107",
            "matching_vid_key": "Network:Entity:242980097970144256"
        }, {
            "metadata": {
                "note": "",
                "creator": "John Smith"
            },
            "vid_key": "Network:Entity:932020953046843423",
            "matching_vid_key": "Network:Entity:847332072480572416"
        }
    ]
}

{
   "suspect_matches" : [
      {
         "suspect_match_id" : "936109874024288767"
      }
   ],
   "errorType" : "UNEXPECTED_ERROR",
   "responseStatus" : "PARTIAL_SUCCESS",
   "errors" : [
      {
         "type" : "UNEXPECTED_ERROR",
         "message" : "No entity found with the given Id Network:Entity:847332072480572416"
      }
   ]
}

Batch Reject Suspect Match

This API enables enables you to reject multiple suspect match tasks.

Endpoint URL

https://dns/api/version/suspect_match/reject/batch

DNS - is the URL for your API service
version - is the API version

This API takes no parameters.

POST Data
suspect_match_ids: An array of suspect match IDs.

Response
responseStatus: The status of the response.
suspect_matches: An array of suspect_matches that correspond to the same objects in the request.

The ID of a processed suspect match.

Notes

responseStatus returns a failure if any standard errors occur.

curl -i -H "Authorization: 57696C6C205261...6368204C6F7368" -H "Content-type: application/json" -X POST -d "@matches_postdata.json" 'https://my.veevanetwork.com/api/v33.0/suspect_match/reject/batch'

{
  "suspect_matches": [
    {
      "suspect_match_id": "936109874024288767"
    },
    {
      "suspect_match_id": "932218031792324671"
    }
    ]
}

{
   "errors" : [
      {
         "message" : "Suspect Match Task 936109874024288767 not found",
         "type" : "INVALID_DATA"
      }
   ],
   "suspect_matches" : [
      {
         "created_date" : "2018-08-05T02:20:41.000-07:00",
         "id" : 932876752875559711,
         "state" : "PENDINGREVIEW",
         "suspect_match_results" : [
            {
               "merge_into_vid" : 242980103305298946,
               "surviving_entity_vid" : 929642136033361951
            }
         ]
      }
   ],
   "responseStatus" : "PARTIAL_SUCCESS"
}

Batch Retrieve Suspect Match

This API enables enables you to retrieve information about multiple suspect matches.

Endpoint URL

https://dns/api/version/suspect_match/batch

DNS - is the URL for your API service
version - is the API version

This API takes no parameters.

POST Data
suspect_match_ids: An array of suspect match IDs.

Response
responseStatus: The status of the response.
suspect_matches: An array of suspect_matches that correspond to the same objects in the request.

id - The ID of the retrieved suspect match task .

resolution_note - The notes added for the suspect match task .

created_date - The date the task was created .

completed_date - The date the task was completed.

resolution - The resolution of the task.

state - The state of the task.

suspect_match_results - Result of suspect match showing the the entity which is merged into the surviving entity.
merge_into_vid - The Network ID of the entity merged into the surviving entity.
surviving_entity_vid - The Network ID of the surviving entity.

Notes

responseStatus returns a failure if any standard errors occur.

curl -i -H "Authorization: 57696C6C205261...6368204C6F7368" -H "Content-type: application/json" -X POST -d "@matches_postdata.json" 'https://my.veevanetwork.com/api/v33.0/suspect_match/batch'

{
  "suspect_matches": [
    {
      "suspect_match_id": "931697085670096927"
    },
    {
      "suspect_match_id": "931697013151105055"
    },
    {
      "suspect_match_id": "932218057214525503"
    }
    ]
}

{
    "responseStatus": "PARTIAL_SUCCESS",
    "errors": [
        {
            "type": "INVALID_DATA",
            "message": "Suspect Match Task 931697085670096927 not found"
        },
        {
            "type": "INVALID_DATA",
            "message": "Suspect Match Task 931697013151105055 not found"
        }
    ],
    "suspect_matches": [
        {
            "id": 932218057214525503,
            "resolution": "NOT_MATCHED",
            "state": "PROCESSED",
            "created_date": "2018-04-10T11:25:43.000-07:00",
            "completed_date": "2018-04-10T11:27:31.000-07:00",
            "suspect_match_results": [
                {
                    "merge_into_vid": 847332072463795200,
                    "surviving_entity_vid": null
                }
            ]
        }
    ]
}

Retrieve entities

This API enables you to obtain information about any entity or child entity (addresses, licenses, and parent HCOs), including custom keys for the entities retrieved.

Retrieve entity

This API enables you to obtain information on any entity without identifying the specific entity type. It is only used to retrieve information from Network using the GET method.

This API downloads the record for the specified entity from Veeva OpenData to your customer instance.

You can only retrieve entries for which you have access permission.

Endpoint URL

https://{DNS}/api/{version}/entity/{vid_key}

DNS is the URL for your API service
version is the API version
vid_key is the key of the entity to retrieve

Optional parameters
systemName: When provided, Network returns target alias values defined for reference codes for this system. Otherwise, Network returns default reference code values.
enrichedResults: Specifies whether or not to display labels for reference type fields in the results.
resultLanguage: Specifies the language to use if the enriched results option is enabled. Uses the IETF BCP 47 language standard.
returnHashtagsForType: Return hashtags for the requested type using the following values:
NETWORK - Display predefined Network hashtags.
ALL - Display Network-defined and custom hashtags.
NONE - Do not display hashtags.

Response
entities: An array of fields and values for each entity.
entityId - The entity ID.
entityType - The entity type.
metaData - Included for structure only; not applicable for this call.
entity - The fields and corresponding values for the entity.
responseStatus: The status of the response in Network.
hashtags: The list of hashtags available to the authenticated API user:
name - the hashtag name.
color - the hashtag color.
tooltip - the tooltip of the hashtag.
tooltipLabel - the field value label of the hashtag.
tooltipValue - the field value of the hashtag.
tooltipHasOtherValue - Returns True if the tooltip has more than three field values.

Notes

Following a retrieve entity call, Network returns all resource information, including custom keys.
The information returned does not include attributes with NULL values.
Network-specific fields are returned regardless of region.

Changelog

Version 19.0 added the enrichedResults and resultLanguage parameters.
Version 25.0 added the returnHashtagsForType parameter.

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" https://my.veevanetwork.com/api/v33.0/entity/932671707694238303

{
   "entities" : [
      {
         "entity" : {
            "vid__v" : "932671707694238303",
            "last_name__v" : "Smith",
            "status_update_time__v" : "2018-06-29T14:15:00.000Z",
            "licenses__v" : [
               {
                  "expiration_date__v" : "2013-12-31",
                  "custom_keys__v" : [],
                  "entity_vid__v" : "932671707694238303",
                  "license_number__v" : "1256987",
                  "license_status__v" : "A",
                  "primary_license__c" : "U",
                  "record_state__v" : "VALID",
                  "record_delta_id__v" : "932671707821604865",
                  "record_owner_name__v" : "Local",
                  "effective_date__v" : "2010-05-05",
                  "address_vid__v" : "932671707694238304",
                  "modified_date__v" : "2018-06-29T14:15:02.000Z",
                  "is_veeva_master__v" : false,
                  "license_status_condition__v" : "0",
                  "record_owner_type__v" : "LOCAL",
                  "created_date__v" : "2018-06-29T14:15:00.000Z",
                  "body__v" : "ALMD",
                  "entity_type__v" : "HCP",
                  "status_update_time__v" : "2018-06-29T14:15:00.000Z",
                  "license_subtype__v" : "U",
                  "vid__v" : "932671707694238305"
               }
            ],
            "specialty_1_rank__v" : 1,
            "created_date__v" : "2018-06-29T14:15:00.000Z",
            "specialty_1__v" : "AC",
            "record_owner_type__v" : "LOCAL",
            "hcp_type__v" : "P",
            "ama_do_not_contact__v" : "N",
            "is_veeva_master__v" : false,
            "hcp_status__v" : "A",
            "kaiser__v" : "N",
            "pdrp_optout__v" : "N",
            "modified_date__v" : "2018-06-29T14:15:02.000Z",
            "record_version__v" : 1,
            "primary_country__v" : "US",
            "first_name__v" : "James",
            "record_owner_name__v" : "Local",
            "record_delta_id__v" : "932671707842248703",
            "fellow__v" : "N",
            "gender__v" : "M",
            "record_state__v" : "VALID",
            "formatted_name__v" : "James Smith",
            "parent_hcos__v" : [],
            "grad_training__v" : "N",
            "addresses__v" : [
               {
                  "premise_number__v" : "326",
                  "latitude__v" : 46.815034,
                  "postal_code_primary__v" : "58501",
                  "ISO_3166_3__v" : "USA",
                  "thoroughfare_trailing_type__v" : "DR",
                  "delivery_address_1__v" : "326 Harolds DR",
                  "record_state__v" : "VALID",
                  "record_owner_name__v" : "Local",
                  "address_status__v" : "A",
                  "address_line_1__v" : "326 Harolds Drive",
                  "longitude__v" : -100.774784,
                  "country__v" : "US",
                  "ISO_3166_n__v" : "840",
                  "created_date__v" : "2018-06-29T14:15:00.000Z",
                  "vid__v" : "932671707694238304",
                  "administrative_area__v" : "US-ND",
                  "locality__v" : "BISMARCK",
                  "custom_keys__v" : [],
                  "thoroughfare__v" : "Harolds DR",
                  "premise__v" : "326",
                  "thoroughfare_name__v" : "Harolds",
                  "entity_vid__v" : "932671707694238303",
                  "record_delta_id__v" : "932671707821604864",
                  "address_type__v" : "P",
                  "modified_date__v" : "2018-06-29T14:15:02.000Z",
                  "address_ordinal__v" : 1,
                  "is_veeva_master__v" : false,
                  "entity_type__v" : "HCP",
                  "record_owner_type__v" : "LOCAL",
                  "formatted_address__v" : "326 Harolds DR BISMARCK ND 58501",
                  "postal_code__v" : "58501",
                  "delivery_address__v" : "326 Harolds DR",
                  "status_update_time__v" : "2018-06-29T14:15:00.000Z",
                  "address_verification_status__v" : "DS"
               }
            ],
            "custom_keys__v" : [
               {
                  "vid__v" : "932671707717372511",
                  "custom_key_source_type__v" : "CUSTOMER__v/3/change_request",
                  "custom_key_value__v" : "932671707694238303",
                  "status_update_time__v" : "2018-06-29T14:15:00.000Z",
                  "custom_key_entity_type__v" : "HCP",
                  "custom_key_vid_key__v" : "CUSTOMER__v/3/change_request:HCP:932671707694238303",
                  "custom_key_entity_id__v" : "932671707694238303",
                  "created_date__v" : "2018-06-29T14:15:00.000Z",
                  "custom_key_item_type__v" : "HCP",
                  "custom_key_status__v" : "A",
                  "modified_date__v" : "2018-06-29T14:15:00.000Z"
               },
               {
                  "modified_date__v" : "2018-06-29T14:15:00.000Z",
                  "vid__v" : "932671707718093407",
                  "custom_key_source_type__v" : "WORKFLOW__v",
                  "custom_key_value__v" : "932671707570838463",
                  "status_update_time__v" : "2018-06-29T14:15:00.000Z",
                  "custom_key_vid_key__v" : "WORKFLOW__v:DCRID__v:932671707570838463",
                  "custom_key_entity_id__v" : "932671707694238303",
                  "custom_key_entity_type__v" : "HCP",
                  "custom_key_status__v" : "A",
                  "custom_key_item_type__v" : "DCRID__v",
                  "created_date__v" : "2018-06-29T14:15:00.000Z"
               }
            ],
            "is_externally_mastered__v" : false
         },
         "entityType" : "HCP",
         "metaData" : {},
         "entityId" : "932671707694238303"
      }
   ],
   "responseStatus" : "SUCCESS"
}

{
    "responseStatus": "SUCCESS",
    "entities": [
        {
            "entityId": "933580259012116863",
            "entityType": "EMPLOYEE__C",
            "metaData": {},
            "entity": {
                "employee_title__c": "Key Account Manager",
                "record_owner_type__v": "LOCAL",
                "employee_status__c": "A",
                "employee_business_unit__c": "Sales",
                "employee_number__c": "103",
                "employee_last_name__c": "Carter",
                "record_delta_id__v": "933580259060776959",
                "record_owner_name__v": "Local",
                "employee_name__c": "Daniel Carter",
                "primary_country__v": "US",
                "created_date__v": "2018-12-07T08:11:33.000Z",
                "employee_first_name__c": "Daniel",
                "employee_hire_date__c": "2018-12-01",
                "is_veeva_master__v": false,
                "status_update_time__v": "2018-12-07T08:11:33.000Z",
                "modified_date__v": "2018-12-07T08:11:33.000Z",
                "record_state__v": "VALID",
                "candidate_record__v": false,
                "record_version__v": 0,
                "vid__v": "933580259012116863",
                "is_externally_mastered__v": false,
                "custom_keys__v": [
                    {
                        "custom_key_entity_id__v": "933580259012116863",
                        "custom_key_item_type__v": "EMPLOYEE__C",
                        "custom_key_value__v": "933580259012116863",
                        "modified_date__v": "2018-12-07T08:11:33.000Z",
                        "vid__v": "933580259018867071",
                        "custom_key_vid_key__v": "CUSTOMER__v/3/change_request:EMPLOYEE__C:933580259012116863",
                        "custom_key_source_type__v": "CUSTOMER__v/3/change_request",
                        "created_date__v": "2018-12-07T08:11:33.000Z",
                        "custom_key_entity_type__v": "EMPLOYEE__C",
                        "custom_key_status__v": "A",
                        "status_update_time__v": "2018-12-07T08:11:33.000Z"
                    },
                    {
                        "custom_key_entity_id__v": "933580259012116863",
                        "custom_key_item_type__v": "DCRID__v",
                        "custom_key_value__v": "933580258951365023",
                        "modified_date__v": "2018-12-07T08:11:33.000Z",
                        "vid__v": "933580259019194751",
                        "custom_key_vid_key__v": "WORKFLOW__v:DCRID__v:933580258951365023",
                        "custom_key_source_type__v": "WORKFLOW__v",
                        "created_date__v": "2018-12-07T08:11:33.000Z",
                        "custom_key_entity_type__v": "EMPLOYEE__C",
                        "custom_key_status__v": "A",
                        "status_update_time__v": "2018-12-07T08:11:33.000Z"
                    }
                ],
                "addresses__v": [
                    {
                        "nwk_primary_address__c": "Y",
                        "address_line_1__v": "200 Park Blvd.",
                        "record_owner_type__v": "LOCAL",
                        "record_delta_id__v": "933580259020275711",
                        "record_owner_name__v": "Local",
                        "locality__v": "San Diego",
                        "country__v": "US",
                        "created_date__v": "2018-12-07T08:11:33.000Z",
                        "is_veeva_master__v": false,
                        "status_update_time__v": "2018-12-07T08:11:33.000Z",
                        "address_type__v": "P",
                        "entity_type__v": "EMPLOYEE__C",
                        "address_verification_status__v": "DS",
                        "address_status__v": "A",
                        "modified_date__v": "2018-12-07T08:11:33.000Z",
                        "record_state__v": "VALID",
                        "vid__v": "933580259012116864",
                        "entity_vid__v": "933580259012116863",
                        "postal_code__v": "91915",
                        "administrative_area__v": "US-CA",
                        "formatted_address__v": "200 Park Blvd. San Diego US-CA 91915",
                        "address_ordinal__v": 1,
                        "custom_keys__v": []
                    }
                ],
                "employee_account_rel_rel_set__c": [
                    {
                        "employee_account_rel_rel_status__c": "A",
                        "related_entity_type__v": "HCO",
                        "record_owner_type__v": "LOCAL",
                        "status_update_time__v": "2018-12-07T08:11:33.000Z",
                        "related_entity_vid__v": "242976972248974337",
                        "related_entity_name__v": "Kindred Hospital San Diego",
                        "record_delta_id__v": "933580259020275712",
                        "entity_type__v": "EMPLOYEE__C",
                        "record_owner_name__v": "Local",
                        "modified_date__v": "2018-12-07T08:11:33.000Z",
                        "record_state__v": "VALID",
                        "is_primary_relationship__v": "N",
                        "vid__v": "933580259012116865",
                        "entity_vid__v": "933580259012116863",
                        "created_date__v": "2018-12-07T08:11:33.000Z",
                        "is_veeva_master__v": false,
                        "custom_keys__v": []
                    }
                ]
            }
        }
    ]
}

Retrieve child entity

This API enables you to retrieve child entity information; for example address or license details, for the Network ID provided without identifying the specific entity type.

This API is only used to retrieve information from Network using the GET method.

Endpoint URL

https://DNS/api/version/child/vid_key

DNS - is the URL for your API service
version - is the API version
vid_key - The key of the entity to retrieve.

Optional Parameters
systemName: When provided, Network returns target alias values defined for reference codes for this system. Otherwise, Network returns default reference code values.
enrichedResults: Specifies whether or not to display labels for reference type fields in the results.
resultLanguage: Specifies the language to use if the enriched results option is enabled. Uses the IETF BCP 47 language standard.

Response
entities: An array of fields and values for each entity.

entityId - The Network ID of the entity.

entityType - The entity type.

metaData - Included for structure only; not applicable for this call.

entity - The fields and corresponding values for the entity.
responseStatus: The status of the response.

Notes

In a customer instance, if a child entity is from master and a new version exists on the master, the child entity is retrieved from master.
If a child entity is up to date or only exists on the customer instance, the child entity is retrieved from the customer instance.
The information returned does not include attributes with NULL values.
Network-specific fields are returned regardless of region.

Changelog

Version 19.0 added the enrichedResults and resultLanguage parameters.

curl -X GET -H "Authorization: 7D8BFC55F6367BE7B7C961884303B5C178F8AF62381A81441D298A73DAB6B70B4AADA399F6BAA8E8B362DEAEBC728DF79531B3F612036798BB687365F7B04724115B43D1C0AC358478CACB4BAF209B5D" https://my.veevanetwork.com/api/v33.0/child/Network:License:942671707694238303

{
   "entities" : [
      {
         "entityType" : "LICENSE",
         "entity" : {
            "expiration_date__v" : "2020-07-31",
            "rxa_eligible__v" : "E",
            "type_value__v" : "IL",
            "entity_vid__v" : "243230954594763778",
            "license_status__v" : "A",
            "record_owner_type__v" : "VOD",
            "status_update_time__v" : "2018-04-23T17:11:38.000Z",
            "is_veeva_master__v" : true,
            "effective_date__v" : "1994-03-21",
            "modified_date__v" : "2018-04-23T17:11:38.000Z",
            "entity_type__v" : "HCP",
            "is_externally_mastered__v" : false,
            "best_state_license__v" : "Y",
            "primary_license__c" : "U",
            "record_state__v" : "VALID",
            "body__v" : "BOME",
            "grace_period__v" : "2020-07-31",
            "type__v" : "STATE",
            "record_owner_name__v" : "OpenData",
            "license_degree__v" : "MD",
            "vid__v" : "929795469719177128",
            "record_delta_id__v" : "942293027461103628",
            "license_number__v" : "036.088139",
            "initial_board_license_date__v" : "2017-07-27",
            "anticipated_expiry_date__v" : "2021-01-27",
            "license_subtype__v" : "U",
            "license_eligibility__v" : "E",
            "created_date__v" : "2018-04-23T17:11:38.000Z",
            "dea_business_activity_code__v" : "ZZ",
            "license_status_condition__v" : "0"
         },
         "entityId" : "929795469719177128",
         "metaData" : {}
      }
   ],
   "responseStatus" : "SUCCESS"
}

Batch retrieve entities

This API enables you to retrieve entity details directly from Network. It is only used to retrieve information using the GET method. To update or delete entity data, you must use the change request APIs.

The entities you can retrieve include HCPs and HCOs, and details are returned for all corresponding child entities: addresses, licenses, parent HCOs, and custom keys.

Endpoint URL

https://{DNS}/api/{version}/entities/batch

DNS is the URL for your API service
version is the API version

This API takes no parameters.

POST data
entities: An array of fields and values for each entity.
vid_key - The external HCP or HCO vid_key supplied by the client.
systemName: When provided, Network returns target alias values defined for reference codes for this system. Otherwise, Network returns default reference code values.
enrichedResults: Specifies whether or not to display labels for reference type fields in the results.
resultLanguage: Specifies the language to use if the enriched results option is enabled. Uses the IETF BCP 47 language standard.

Response
responseStatus: The status of the response in Network.
errors: An array of errors.
type - The error type.
message - A detailed message for the error type. This message is subject to change and is not contractual for error handling.
entities: An array of fields and values for each entity.
entityType - The entity type.
metaData - Included for structure only; not applicable for this call.
entity - The fields and corresponding values for the entity.

Notes

responseStatus returns a failure if standard errors occur.
responseStatus returns PARTIAL_SUCCESS if:
- vid_key does not represent an existing entity.
- the entity specified by vid_key is not an HCP or HCO.
Batch API calls are limited to 500 operations per call. An attempt to submit more operations will results in a failure of all operations in the call.

Changelog

Version 19.0 added the enrichedResults and resultLanguage parameters.

curl -i -H "Authorization: F3C27EF4A0B216C72EC572E16C27C6DF137FC14ED97E2596C119938191AD8E94A978C02B53C0B382E0CC5674561C09A82024A685D146331ADB247B53129DD28EA302134286133710E6DDAD1A96C7EB0D" -H "Content-type: application/json" -X POST -d "@vid_postdata.json" https://my.veevanetwork.com/api/v33.0/entities/batch

{
  "entities": [
    {
      "vid_key": "Network:Entity:932315773830225247"
    },
    {
      "vid_key": "Network:Entity:932910724243720799"
    },
    {
      "vid_key": "Network:Entity:932241620698597983"
    }
  ],
  "systemName": "change_request",
  "enrichedResults": "true",
  "resultLanguage": "en"
}

{ 
   "responseStatus":"SUCCESS",
   "entities":[ 
      { 
         "entityId":"932315773830225247",
         "entityType":"HCP",
         "metaData":{ 

         },
         "entity":{ 
            "gender__v":"M",
            "gender__v_value__u":"Male",
            "specialty_1__v":"AC",
            "specialty_1__v_value__u":"Acute Care",
            "hcp_type__v":"P",
            "hcp_type__v_value__u":"Prescriber",
            "first_name__v":"James",
            "record_owner_type__v":"LOCAL",
            "record_owner_type__v_value__u":"Locally Managed",
            "grad_training__v":"N",
            "grad_training__v_value__u":"No/False",
            "record_delta_id__v":"932315774409474047",
            "last_name__v":"Smith",
            "record_owner_name__v":"Local",
            "fellow__v":"N",
            "fellow__v_value__u":"No/False",
            "kaiser__v":"N",
            "kaiser__v_value__u":"No/False",
            "formatted_name__v":"James Smith",
            "primary_country__v":"US",
            "primary_country__v_value__u":"United States",
            "created_date__v":"2018-04-27T17:36:28.000Z",
            "pdrp_optout__v":"N",
            "pdrp_optout__v_value__u":"No/False",
            "is_veeva_master__v":false,
            "hcp_status__v":"A",
            "hcp_status__v_value__u":"Active",
            "ama_do_not_contact__v":"N",
            "ama_do_not_contact__v_value__u":"No/False",
            "status_update_time__v":"2018-04-27T17:36:27.000Z",
            "entity_type__v":"HCP",
            "entity_type__v_value__u":"Health Care Professional",
            "modified_date__v":"2018-04-27T17:36:28.000Z",
            "record_state__v":"UNDER_REVIEW",
            "record_state__v_value__u":"Under Review",
            "record_version__v":0,
            "vid__v":"932315773830225247",
            "is_externally_mastered__v":false,
            "specialty_1_rank__v":1,
            "addresses__v":[ 
               { 
                  "dpv_confirmed_indicator__v":"X",
                  "dpv_confirmed_indicator__v_value__u":"The address was not submitted for DPV confirmation",
                  "postal_code_primary__v":"58501",
                  "address_line_1__v":"326 Harolds Dr",
                  "record_owner_type__v":"LOCAL",
                  "record_owner_type__v_value__u":"Locally Managed",
                  "premise__v":"326",
                  "record_delta_id__v":"932315774330634240",
                  "record_owner_name__v":"Local",
                  "thoroughfare_trailing_type__v":"Dr",
                  "locality__v":"Bismarck",
                  "delivery_address__v":"326 Harolds Dr",
                  "administrative_area_parsed__v":"ND",
                  "country__v":"US",
                  "country__v_value__u":"United States",
                  "created_date__v":"2018-04-27T17:36:28.000Z",
                  "premise_number__v":"326",
                  "is_veeva_master__v":false,
                  "ISO_3166_3__v":"USA",
                  "ISO_3166_3__v_value__u":"United States",
                  "ISO_3166_n__v":"840",
                  "ISO_3166_n__v_value__u":"United States",
                  "thoroughfare__v":"Harolds Dr",
                  "status_update_time__v":"2018-04-27T17:36:28.000Z",
                  "address_type__v":"P",
                  "address_type__v_value__u":"Professional",
                  "delivery_address_1__v":"326 Harolds Dr",
                  "sub_administrative_area__v":"Burleigh",
                  "entity_type__v":"HCP",
                  "entity_type__v_value__u":"Health Care Professional",
                  "address_verification_status__v":"P",
                  "address_verification_status__v_value__u":"Partially Verified",
                  "address_status__v":"A",
                  "address_status__v_value__u":"Active",
                  "modified_date__v":"2018-04-27T17:36:28.000Z",
                  "record_state__v":"UNDER_REVIEW",
                  "record_state__v_value__u":"Under Review",
                  "vid__v":"932315773850225248",
                  "entity_vid__v":"932315773830225247",
                  "postal_code__v":"58501",
                  "administrative_area__v":"US-ND",
                  "administrative_area__v_value__u":"North Dakota",
                  "formatted_address__v":"326 Harolds Dr Bismarck ND 58501",
                  "latitude__v":46.815034,
                  "address_ordinal__v":1,
                  "thoroughfare_name__v":"Harolds",
                  "longitude__v":-100.774784,
                  "custom_keys__v":[ 

                  ],
                  "entity_type__u":"ADDRESS",
                  "object_name__u":"ADDRESS"
               }
            ],
            "custom_keys__v":[ 
               { 
                  "custom_key_entity_id__v":"932315773830225247",
                  "custom_key_item_type__v":"DCRID__v",
                  "custom_key_value__v":"932315773398571455",
                  "modified_date__v":"2018-04-27T17:36:28.000Z",
                  "vid__v":"932315774299736671",
                  "custom_key_vid_key__v":"WORKFLOW__v:DCRID__v:932315773598571455",
                  "custom_key_source_type__v":"WORKFLOW__v",
                  "created_date__v":"2018-04-27T17:36:28.000Z",
                  "custom_key_entity_type__v":"HCP",
                  "custom_key_status__v":"A",
                  "custom_key_status__v_value__u":"Active",
                  "status_update_time__v":"2018-04-27T17:36:28.000Z",
                  "entity_type__v":"EXTERNALKEYS",
                  "entity_type__v_value__u":"EXTERNALKEYS",
                  "entity_type__u":"EXTERNALKEYS",
                  "object_name__u":"CUSTOMKEY"
               },
               { 
                  "custom_key_entity_id__v":"932315773830225247",
                  "custom_key_item_type__v":"HCP",
                  "custom_key_value__v":"932315773830225247",
                  "modified_date__v":"2018-04-27T17:36:28.000Z",
                  "vid__v":"932315774291741279",
                  "custom_key_vid_key__v":"CUSTOMER__v/3/change_request:HCP:932315773830225247",
                  "custom_key_source_type__v":"CUSTOMER__v/3/change_request",
                  "created_date__v":"2018-04-27T17:36:28.000Z",
                  "custom_key_entity_type__v":"HCP",
                  "custom_key_status__v":"A",
                  "custom_key_status__v_value__u":"Active",
                  "status_update_time__v":"2018-04-27T17:36:28.000Z",
                  "entity_type__v":"EXTERNALKEYS",
                  "entity_type__v_value__u":"EXTERNALKEYS",
                  "entity_type__u":"EXTERNALKEYS",
                  "object_name__u":"CUSTOMKEY"
               }
            ],
            "licenses__v":[ 
               { 
                  "primary_license__c":"U",
                  "primary_license__c_value__u":"Unknown/No response",
                  "address_vid__v":"932315773830225248",
                  "record_owner_type__v":"LOCAL",
                  "record_owner_type__v_value__u":"Locally Managed",
                  "effective_date__v":"2010-05-05",
                  "license_number__v":"1256987",
                  "status_update_time__v":"2018-04-27T17:36:28.000Z",
                  "record_delta_id__v":"932315774330634241",
                  "license_status__v":"A",
                  "license_status__v_value__u":"Active",
                  "entity_type__v":"HCP",
                  "entity_type__v_value__u":"Health Care Professional",
                  "record_owner_name__v":"Local",
                  "expiration_date__v":"2013-12-31",
                  "body__v":"ALMD",
                  "modified_date__v":"2018-04-27T17:36:28.000Z",
                  "record_state__v":"UNDER_REVIEW",
                  "record_state__v_value__u":"Under Review",
                  "license_status_condition__v":"0",
                  "license_status_condition__v_value__u":"No Known Conditions",
                  "license_subtype__v":"U",
                  "license_subtype__v_value__u":"Unlimited",
                  "vid__v":"932315773830225249",
                  "entity_vid__v":"932315773850225247",
                  "created_date__v":"2018-04-27T17:36:28.000Z",
                  "is_veeva_master__v":false,
                  "custom_keys__v":[ 

                  ],
                  "entity_type__u":"LICENSE",
                  "object_name__u":"LICENSE",
                  "address_vid__v_value__u":"326 Harolds Dr Bismarck ND 58501"
               }
            ],
            "parent_hcos__v":[ 

            ],
            "entity_type__u":"HCP",
            "object_name__u":"HCP"
         }
      },
      { 
         "entityId":"932910724243720799",
         "entityType":"HCP",
         "metaData":{ 

         },
         "entity":{ 
            "gender__v":"M",
            "gender__v_value__u":"Male",
            "specialty_1__v":"AC",
            "specialty_1__v_value__u":"Acute Care",
            "hcp_type__v":"P",
            "hcp_type__v_value__u":"Prescriber",
            "first_name__v":"Miranda",
            "record_owner_type__v":"LOCAL",
            "record_owner_type__v_value__u":"Locally Managed",
            "grad_training__v":"N",
            "grad_training__v_value__u":"No/False",
            "record_delta_id__v":"932910724917329920",
            "last_name__v":"Jane",
            "record_owner_name__v":"Local",
            "fellow__v":"N",
            "fellow__v_value__u":"No/False",
            "kaiser__v":"N",
            "kaiser__v_value__u":"No/False",
            "formatted_name__v":"Miranda Jane",
            "primary_country__v":"US",
            "primary_country__v_value__u":"United States",
            "created_date__v":"2018-08-10T19:20:09.000Z",
            "pdrp_optout__v":"N",
            "pdrp_optout__v_value__u":"No/False",
            "is_veeva_master__v":false,
            "hcp_status__v":"A",
            "hcp_status__v_value__u":"Active",
            "ama_do_not_contact__v":"N",
            "ama_do_not_contact__v_value__u":"No/False",
            "status_update_time__v":"2018-08-10T19:20:08.000Z",
            "entity_type__v":"HCP",
            "entity_type__v_value__u":"Health Care Professional",
            "modified_date__v":"2018-08-10T19:20:11.000Z",
            "record_state__v":"VALID",
            "record_state__v_value__u":"Valid",
            "record_version__v":1,
            "vid__v":"932910724243720799",
            "is_externally_mastered__v":false,
            "specialty_1_rank__v":1,
            "addresses__v":[ 
               { 
                  "postal_code_primary__v":"58501",
                  "address_line_1__v":"326 Harolds Drive",
                  "record_owner_type__v":"LOCAL",
                  "record_owner_type__v_value__u":"Locally Managed",
                  "premise__v":"326",
                  "record_delta_id__v":"932910724760764415",
                  "record_owner_name__v":"Local",
                  "thoroughfare_trailing_type__v":"DR",
                  "locality__v":"BISMARCK",
                  "delivery_address__v":"326 Harolds DR",
                  "country__v":"US",
                  "country__v_value__u":"United States",
                  "created_date__v":"2018-08-10T19:20:09.000Z",
                  "premise_number__v":"326",
                  "is_veeva_master__v":false,
                  "ISO_3166_3__v":"USA",
                  "ISO_3166_3__v_value__u":"United States",
                  "ISO_3166_n__v":"840",
                  "ISO_3166_n__v_value__u":"United States",
                  "thoroughfare__v":"Harolds DR",
                  "status_update_time__v":"2018-08-10T19:20:09.000Z",
                  "address_type__v":"P",
                  "address_type__v_value__u":"Professional",
                  "delivery_address_1__v":"326 Harolds DR",
                  "entity_type__v":"HCP",
                  "entity_type__v_value__u":"Health Care Professional",
                  "address_verification_status__v":"DS",
                  "address_verification_status__v_value__u":"Data Steward Approved",
                  "address_status__v":"A",
                  "address_status__v_value__u":"Active",
                  "modified_date__v":"2018-08-10T19:20:11.000Z",
                  "record_state__v":"VALID",
                  "record_state__v_value__u":"Valid",
                  "vid__v":"932910724244965983",
                  "entity_vid__v":"932910724243720799",
                  "postal_code__v":"58501",
                  "administrative_area__v":"US-ND",
                  "administrative_area__v_value__u":"North Dakota",
                  "formatted_address__v":"326 Harolds DR BISMARCK ND 58501",
                  "latitude__v":46.815034,
                  "address_ordinal__v":1,
                  "thoroughfare_name__v":"Harolds",
                  "longitude__v":-100.774784,
                  "custom_keys__v":[ 

                  ],
                  "entity_type__u":"ADDRESS",
                  "object_name__u":"ADDRESS"
               }
            ],
            "custom_keys__v":[ 
               { 
                  "custom_key_entity_id__v":"932910724243720799",
                  "custom_key_item_type__v":"DCRID__v",
                  "custom_key_value__v":"932910723585545759",
                  "modified_date__v":"2018-08-10T19:20:09.000Z",
                  "vid__v":"932910724587260511",
                  "custom_key_vid_key__v":"WORKFLOW__v:DCRID__v:932910723585545759",
                  "custom_key_source_type__v":"WORKFLOW__v",
                  "created_date__v":"2018-08-10T19:20:09.000Z",
                  "custom_key_entity_type__v":"HCP",
                  "custom_key_status__v":"A",
                  "custom_key_status__v_value__u":"Active",
                  "status_update_time__v":"2018-08-10T19:20:09.000Z",
                  "entity_type__v":"EXTERNALKEYS",
                  "entity_type__v_value__u":"EXTERNALKEYS",
                  "entity_type__u":"EXTERNALKEYS",
                  "object_name__u":"CUSTOMKEY"
               },
               { 
                  "custom_key_entity_id__v":"932910724243720799",
                  "custom_key_item_type__v":"HCP",
                  "custom_key_value__v":"932910724243720799",
                  "modified_date__v":"2018-08-10T19:20:09.000Z",
                  "vid__v":"932910724572908127",
                  "custom_key_vid_key__v":"CUSTOMER__v/3/change_request:HCP:932910724243720799",
                  "custom_key_source_type__v":"CUSTOMER__v/3/change_request",
                  "created_date__v":"2018-08-10T19:20:09.000Z",
                  "custom_key_entity_type__v":"HCP",
                  "custom_key_status__v":"A",
                  "custom_key_status__v_value__u":"Active",
                  "status_update_time__v":"2018-08-10T19:20:09.000Z",
                  "entity_type__v":"EXTERNALKEYS",
                  "entity_type__v_value__u":"EXTERNALKEYS",
                  "entity_type__u":"EXTERNALKEYS",
                  "object_name__u":"CUSTOMKEY"
               }
            ],
            "licenses__v":[ 
               { 
                  "primary_license__c":"U",
                  "primary_license__c_value__u":"Unknown/No response",
                  "address_vid__v":"932910724244965983",
                  "record_owner_type__v":"LOCAL",
                  "record_owner_type__v_value__u":"Locally Managed",
                  "effective_date__v":"2010-05-05",
                  "license_number__v":"1256987",
                  "status_update_time__v":"2018-08-10T19:20:09.000Z",
                  "record_delta_id__v":"932910724760764416",
                  "license_status__v":"A",
                  "license_status__v_value__u":"Active",
                  "entity_type__v":"HCP",
                  "entity_type__v_value__u":"Health Care Professional",
                  "record_owner_name__v":"Local",
                  "expiration_date__v":"2013-12-31",
                  "body__v":"ALMD",
                  "modified_date__v":"2018-08-10T19:20:11.000Z",
                  "record_state__v":"VALID",
                  "record_state__v_value__u":"Valid",
                  "license_status_condition__v":"0",
                  "license_status_condition__v_value__u":"No Known Conditions",
                  "license_subtype__v":"U",
                  "license_subtype__v_value__u":"Unlimited",
                  "vid__v":"932910724244965984",
                  "entity_vid__v":"932910724243720799",
                  "created_date__v":"2018-08-10T19:20:09.000Z",
                  "is_veeva_master__v":false,
                  "custom_keys__v":[ 

                  ],
                  "entity_type__u":"LICENSE",
                  "object_name__u":"LICENSE",
                  "address_vid__v_value__u":"326 Harolds DR BISMARCK ND 58501"
               }
            ],
            "parent_hcos__v":[ 

            ],
            "entity_type__u":"HCP",
            "object_name__u":"HCP"
         }
      },
      { 
         "entityId":"932241620698597983",
         "entityType":"HCP",
         "metaData":{ 

         },
         "entity":{ 
            "gender__v":"M",
            "gender__v_value__u":"Male",
            "specialty_1__v":"AC",
            "specialty_1__v_value__u":"Acute Care",
            "hcp_type__v":"P",
            "hcp_type__v_value__u":"Prescriber",
            "first_name__v":"Wilf",
            "record_owner_type__v":"LOCAL",
            "record_owner_type__v_value__u":"Locally Managed",
            "grad_training__v":"N",
            "grad_training__v_value__u":"No/False",
            "record_delta_id__v":"932241620768227327",
            "last_name__v":"Knoxford",
            "record_owner_name__v":"Local",
            "fellow__v":"N",
            "fellow__v_value__u":"No/False",
            "kaiser__v":"N",
            "kaiser__v_value__u":"No/False",
            "formatted_name__v":"Wilf Knoxford",
            "primary_country__v":"US",
            "primary_country__v_value__u":"United States",
            "created_date__v":"2018-04-14T15:18:14.000Z",
            "pdrp_optout__v":"N",
            "pdrp_optout__v_value__u":"No/False",
            "is_veeva_master__v":false,
            "hcp_status__v":"A",
            "hcp_status__v_value__u":"Active",
            "ama_do_not_contact__v":"N",
            "ama_do_not_contact__v_value__u":"No/False",
            "status_update_time__v":"2018-04-14T15:18:14.000Z",
            "entity_type__v":"HCP",
            "entity_type__v_value__u":"Health Care Professional",
            "modified_date__v":"2018-04-14T15:18:14.000Z",
            "record_state__v":"UNDER_REVIEW",
            "record_state__v_value__u":"Under Review",
            "record_version__v":0,
            "vid__v":"932241620698597983",
            "is_externally_mastered__v":false,
            "specialty_1_rank__v":1,
            "addresses__v":[ 
               { 
                  "dpv_confirmed_indicator__v":"X",
                  "dpv_confirmed_indicator__v_value__u":"The address was not submitted for DPV confirmation",
                  "postal_code_primary__v":"58501",
                  "address_line_1__v":"326 Harolds Dr",
                  "record_owner_type__v":"LOCAL",
                  "record_owner_type__v_value__u":"Locally Managed",
                  "premise__v":"326",
                  "record_delta_id__v":"932241620746207232",
                  "record_owner_name__v":"Local",
                  "thoroughfare_trailing_type__v":"Dr",
                  "locality__v":"Bismarck",
                  "delivery_address__v":"326 Harolds Dr",
                  "administrative_area_parsed__v":"ND",
                  "country__v":"US",
                  "country__v_value__u":"United States",
                  "created_date__v":"2018-04-14T15:18:14.000Z",
                  "premise_number__v":"326",
                  "is_veeva_master__v":false,
                  "ISO_3166_3__v":"USA",
                  "ISO_3166_3__v_value__u":"United States",
                  "ISO_3166_n__v":"840",
                  "ISO_3166_n__v_value__u":"United States",
                  "thoroughfare__v":"Harolds Dr",
                  "status_update_time__v":"2018-04-14T15:18:14.000Z",
                  "address_type__v":"P",
                  "address_type__v_value__u":"Professional",
                  "delivery_address_1__v":"326 Harolds Dr",
                  "sub_administrative_area__v":"Burleigh",
                  "entity_type__v":"HCP",
                  "entity_type__v_value__u":"Health Care Professional",
                  "address_verification_status__v":"P",
                  "address_verification_status__v_value__u":"Partially Verified",
                  "address_status__v":"A",
                  "address_status__v_value__u":"Active",
                  "modified_date__v":"2018-04-14T15:18:14.000Z",
                  "record_state__v":"UNDER_REVIEW",
                  "record_state__v_value__u":"Under Review",
                  "vid__v":"932241620698597984",
                  "entity_vid__v":"932241620698597983",
                  "postal_code__v":"58501",
                  "administrative_area__v":"US-ND",
                  "administrative_area__v_value__u":"North Dakota",
                  "formatted_address__v":"326 Harolds Dr Bismarck ND 58501",
                  "latitude__v":46.815034,
                  "address_ordinal__v":1,
                  "thoroughfare_name__v":"Harolds",
                  "longitude__v":-100.774784,
                  "custom_keys__v":[ 

                  ],
                  "entity_type__u":"ADDRESS",
                  "object_name__u":"ADDRESS"
               }
            ],
            "custom_keys__v":[ 
               { 
                  "custom_key_entity_id__v":"932241620698597983",
                  "custom_key_item_type__v":"HCP",
                  "custom_key_value__v":"932241620698597983",
                  "modified_date__v":"2018-04-14T15:18:14.000Z",
                  "vid__v":"932241620721404511",
                  "custom_key_vid_key__v":"CUSTOMER__v/3/change_request:HCP:932241620698597983",
                  "custom_key_source_type__v":"CUSTOMER__v/3/change_request",
                  "created_date__v":"2018-04-14T15:18:14.000Z",
                  "custom_key_entity_type__v":"HCP",
                  "custom_key_status__v":"A",
                  "custom_key_status__v_value__u":"Active",
                  "status_update_time__v":"2018-04-14T15:18:14.000Z",
                  "entity_type__v":"EXTERNALKEYS",
                  "entity_type__v_value__u":"EXTERNALKEYS",
                  "entity_type__u":"EXTERNALKEYS",
                  "object_name__u":"CUSTOMKEY"
               },
               { 
                  "custom_key_entity_id__v":"932241620698597983",
                  "custom_key_item_type__v":"DCRID__v",
                  "custom_key_value__v":"932241620548916767",
                  "modified_date__v":"2018-04-14T15:18:14.000Z",
                  "vid__v":"932241620725926495",
                  "custom_key_vid_key__v":"WORKFLOW__v:DCRID__v:932241620548916767",
                  "custom_key_source_type__v":"WORKFLOW__v",
                  "created_date__v":"2018-04-14T15:18:14.000Z",
                  "custom_key_entity_type__v":"HCP",
                  "custom_key_status__v":"A",
                  "custom_key_status__v_value__u":"Active",
                  "status_update_time__v":"2018-04-14T15:18:14.000Z",
                  "entity_type__v":"EXTERNALKEYS",
                  "entity_type__v_value__u":"EXTERNALKEYS",
                  "entity_type__u":"EXTERNALKEYS",
                  "object_name__u":"CUSTOMKEY"
               }
            ],
            "licenses__v":[ 
               { 
                  "primary_license__c":"U",
                  "primary_license__c_value__u":"Unknown/No response",
                  "address_vid__v":"932241620698597984",
                  "record_owner_type__v":"LOCAL",
                  "record_owner_type__v_value__u":"Locally Managed",
                  "effective_date__v":"2010-05-05",
                  "license_number__v":"1256987",
                  "status_update_time__v":"2018-04-14T15:18:14.000Z",
                  "record_delta_id__v":"932241620746207233",
                  "license_status__v":"A",
                  "license_status__v_value__u":"Active",
                  "entity_type__v":"HCP",
                  "entity_type__v_value__u":"Health Care Professional",
                  "record_owner_name__v":"Local",
                  "expiration_date__v":"2013-12-31",
                  "body__v":"ALMD",
                  "modified_date__v":"2018-04-14T15:18:14.000Z",
                  "record_state__v":"UNDER_REVIEW",
                  "record_state__v_value__u":"Under Review",
                  "license_status_condition__v":"0",
                  "license_status_condition__v_value__u":"No Known Conditions",
                  "license_subtype__v":"U",
                  "license_subtype__v_value__u":"Unlimited",
                  "vid__v":"932241620698597985",
                  "entity_vid__v":"932241620698597983",
                  "created_date__v":"2018-04-14T15:18:14.000Z",
                  "is_veeva_master__v":false,
                  "custom_keys__v":[ 

                  ],
                  "entity_type__u":"LICENSE",
                  "object_name__u":"LICENSE",
                  "address_vid__v_value__u":"326 Harolds Dr Bismarck ND 58501"
               }
            ],
            "parent_hcos__v":[ 

            ],
            "entity_type__u":"HCP",
            "object_name__u":"HCP"
         }
      }
   ]
}

Batch retrieve child entities

This API enables you to obtain information on child entities without identifying the specific entity type. Users are only allowed to retrieve (GET) information from Network.

All other operations (POST and DELETE) are restricted and can only be performed by submitting a change request using the change request APIs.

Endpoint URL

https://DNS/api/version/children/batch

DNS - is the URL for your API service
version - is the API version

This API takes no parameters.

POST Data
entities: An array of objects:

vid_key - The external child entity; for example, license or address vid_key supplied by the client.
systemName: When provided, Network returns target alias values defined for reference codes for this system. Otherwise, Network returns default reference code values.
enrichedResults: Specifies whether or not to display labels for reference type fields in the results.
resultLanguage: Specifies the language to use if the enriched results option is enabled. Uses the IETF BCP 47 language standard.

Response
responseStatus: The status of the response.
errors: An array of errors.

The error type.

A detailed message for the error type. This message is subject to change and is not contractual for error handling.
entities: An array of fields and values for each entity.

entityId - The Network ID of the entity.

entityType - The entity type.

metaData - Included for structure only; not applicable for this call.

entity - The fields and corresponding values for the entity.

Notes

If no revisions exist in the given range:

If the corresponding child entity is from master and a newer version exists in the master, the child entity is retrieved from the master.
If the corresponding child entity is up to date or exists only in the customer instance, that child entity is retrieved from the customer instance.
responseStatus returns a failure if standard errors occur.
responseStatus returns PARTIAL_SUCCESS if:
- vid_key does not represent an existing entity.
- The entity specified by vid_key is not an HCP or HCO.
Batch API calls are limited to 500 operations per call. An attempt to submit more operations will result in all call operations failing.

Changelog

Version 19.0 added the enrichedResults and resultLanguage parameters.

curl -i -H "Authorization: F3C27EF4A0B216C72EC572E16C27C6DF137FC14ED97E2596C119938191AD8E94A978C02B53C0B382E0CC5674561C09A82024A685D146331ADB247B53129DD28EA302134286133710E6DDAD1A96C7EB0D" -H "Content-type: application/json" -X POST -d "@vid_postdata_license.json" https://my.veevanetwork.com/api/v33.0/children/batch

{
  "entities": [
    {
      "vid_key": "Network:License:935315773850225249"
    },
    {
      "vid_key": "Network:License:932910724244965984"
    },
    {
      "vid_key": "Network:License:932241620698597985"
    }
  ],
  "systemName": "change_request",
  "enrichedResults": "true",
  "resultLanguage": "en"
}

{ 
   "responseStatus":"PARTIAL_SUCCESS",
   "errors":[ 
      { 
         "type":"INVALID_DATA",
         "message":"No entity found with the given Id Network:License:935315773850225249"
      }
   ],
   "entities":[ 
      { 
         "entityId":"932241620698597985",
         "entityType":"LICENSE",
         "metaData":{ 

         },
         "entity":{ 
            "primary_license__c":"U",
            "primary_license__c_value__u":"Unknown/No response",
            "address_vid__v":"932241620698597984",
            "record_owner_type__v":"LOCAL",
            "record_owner_type__v_value__u":"Locally Managed",
            "effective_date__v":"2010-05-05",
            "license_number__v":"1256987",
            "status_update_time__v":"2018-04-14T15:18:14.000Z",
            "record_delta_id__v":"932241620746207233",
            "license_status__v":"A",
            "license_status__v_value__u":"Active",
            "entity_type__v":"HCP",
            "entity_type__v_value__u":"Health Care Professional",
            "record_owner_name__v":"Local",
            "expiration_date__v":"2013-12-31",
            "body__v":"ALMD",
            "modified_date__v":"2018-04-14T15:18:14.000Z",
            "record_state__v":"UNDER_REVIEW",
            "record_state__v_value__u":"Under Review",
            "license_status_condition__v":"0",
            "license_status_condition__v_value__u":"No Known Conditions",
            "license_subtype__v":"U",
            "license_subtype__v_value__u":"Unlimited",
            "vid__v":"932241620698597985",
            "entity_vid__v":"932241620698597983",
            "created_date__v":"2018-04-14T15:18:14.000Z",
            "is_veeva_master__v":false,
            "entity_type__u":"LICENSE",
            "object_name__u":"LICENSE",
            "address_vid__v_value__u":"326 Harolds Dr Bismarck ND 58501"
         }
      },
      { 
         "entityId":"932910724244965984",
         "entityType":"LICENSE",
         "metaData":{ 

         },
         "entity":{ 
            "primary_license__c":"U",
            "primary_license__c_value__u":"Unknown/No response",
            "address_vid__v":"932910724244965983",
            "record_owner_type__v":"LOCAL",
            "record_owner_type__v_value__u":"Locally Managed",
            "effective_date__v":"2010-05-05",
            "license_number__v":"1256987",
            "status_update_time__v":"2018-08-10T19:20:09.000Z",
            "record_delta_id__v":"932910724760764416",
            "license_status__v":"A",
            "license_status__v_value__u":"Active",
            "entity_type__v":"HCP",
            "entity_type__v_value__u":"Health Care Professional",
            "record_owner_name__v":"Local",
            "expiration_date__v":"2013-12-31",
            "body__v":"ALMD",
            "modified_date__v":"2018-08-10T19:20:11.000Z",
            "record_state__v":"VALID",
            "record_state__v_value__u":"Valid",
            "license_status_condition__v":"0",
            "license_status_condition__v_value__u":"No Known Conditions",
            "license_subtype__v":"U",
            "license_subtype__v_value__u":"Unlimited",
            "vid__v":"932910724244965984",
            "entity_vid__v":"932910724243720799",
            "created_date__v":"2018-08-10T19:20:09.000Z",
            "is_veeva_master__v":false,
            "entity_type__u":"LICENSE",
            "object_name__u":"LICENSE",
            "address_vid__v_value__u":"326 Harolds DR BISMARCK ND 58501"
         }
      }
   ]
}

Health care organization

The health care organization API enable you to retrieve HCO information and associate custom keys with or disassociate them from other entities.

Retrieve HCO

This API enables you to retrieve information about an HCO. Information you can retrieve for an HCO includes the HCO, address, license, and parent HCO information (including their custom keys) for the HCO vid_key you provide.

This API downloads the record for the specified entity from Veeva OpenData to your customer instance.

Endpoint URL

https://DNS/api/version/hcos/vid_key

DNS - is the URL for your API service
version - is the API version
vid_key - The key of the entity to retrieve.

Optional Parameters
systemName: When provided, Network returns target alias values defined for reference codes for this system. Otherwise, Network returns default reference code values.
enrichedResults: Specifies whether or not to display labels for reference type fields in the results.
resultLanguage: Specifies the language to use if the enriched results option is enabled. Uses the IETF BCP 47 language standard.
returnHashtagsForType: Return hashtags for the requested type using the following values:
NETWORK - Display predefined Network hashtags.
ALL - Display Network-defined and custom hashtags.
NONE - Do not display hashtags.

Response
responseStatus: The status of the response.
entities: An array of fields and values for each entity.

entityId - The Network ID of the entity.

entityType - The entity type.

metaData - Included for structure only; not applicable for this call.

entity - The fields and corresponding values for the entity.
hashtags: The list of hashtags available to the authenticated API user:
name - the hashtag name.
color - the hashtag color.
tooltip - the tooltip of the hashtag.
tooltipLabel - the field value label of the hashtag.
tooltipValue - the field value of the hashtag.
tooltipHasOtherValue - Returns True if the tooltip has more than three field values.

Notes

Following this call, Network returns all resource information, including addresses, licenses, parent HCOs, and custom keys.
The information returned does not include attributes with null values.
Some Network-specific fields are returned regardless of the region.

Changelog

Version 19.0 added the enrichedResults and resultLanguage parameters.
Version 25.0 added the returnHashtagsForType parameter.

curl -X GET -H "Authorization: 57696C6C205261...6368204A6F7368" https://my.veevanetwork.com/api/v33.0/hcos/Network:Entity:932241745093790303

{
   "responseStatus" : "SUCCESS",
   "entities" : [
      {
         "entityId" : "932241745093790303",
         "entityType" : "HCO",
         "metaData" : {},
         "entity" : {
            "hco_status__v" : "A",
            "primary_country__v" : "US",
            "training_facility__v" : "N",
            "parent_hcos__v" : [],
            "is_veeva_master__v" : false,
            "created_date__v" : "2018-04-14T15:49:51.000Z",
            "record_version__v" : 1,
            "status_update_time__v" : "2018-04-14T15:49:51.000Z",
            "record_state__v" : "VALID",
            "record_owner_name__v" : "Local",
            "xray_services__v" : "N",
            "addresses__v" : [
               {
                  "premise__v" : "15",
                  "address_ordinal__v" : 1,
                  "record_owner_type__v" : "LOCAL",
                  "custom_keys__v" : [],
                  "administrative_area_parsed__v" : "NY",
                  "delivery_address_1__v" : "15 Central Park W",
                  "record_owner_name__v" : "Local",
                  "ISO_3166_3__v" : "USA",
                  "locality__v" : "New York",
                  "longitude__v" : -73.98088,
                  "administrative_area__v" : "US-NY",
                  "premise_number__v" : "15",
                  "is_veeva_master__v" : false,
                  "ISO_3166_n__v" : "840",
                  "address_verification_status__v" : "P",
                  "thoroughfare_trailing_type__v" : "Park",
                  "address_line_1__v" : "15 Central Park W",
                  "thoroughfare_post_direction__v" : "W",
                  "modified_date__v" : "2018-04-14T15:50:18.000Z",
                  "postal_code__v" : "10023",
                  "vid__v" : "932241745093790304",
                  "record_delta_id__v" : "932241746852020224",
                  "entity_vid__v" : "932241745093790303",
                  "entity_type__v" : "HCO",
                  "thoroughfare__v" : "Central Park W",
                  "thoroughfare_name__v" : "Central",
                  "country__v" : "US",
                  "address_status__v" : "A",
                  "dpv_confirmed_indicator__v" : "X",
                  "latitude__v" : 40.76973,
                  "created_date__v" : "2018-04-14T15:49:51.000Z",
                  "address_type__v" : "B",
                  "formatted_address__v" : "15 Central Park W New York NY 10023",
                  "record_state__v" : "VALID",
                  "postal_code_primary__v" : "10023",
                  "delivery_address__v" : "15 Central Park W",
                  "sub_administrative_area__v" : "New York",
                  "status_update_time__v" : "2018-04-14T15:49:51.000Z"
               }
            ],
            "va_dod_affiliated__v" : "U",
            "custom_keys__v" : [
               {
                  "custom_key_status__v" : "A",
                  "custom_key_entity_id__v" : "932241745093790303",
                  "custom_key_entity_type__v" : "HCO",
                  "custom_key_value__v" : "932241745093790303",
                  "custom_key_source_type__v" : "CUSTOMER__v/3/change_request",
                  "modified_date__v" : "2018-04-14T15:49:51.000Z",
                  "vid__v" : "932241745111681631",
                  "custom_key_item_type__v" : "HCO",
                  "status_update_time__v" : "2018-04-14T15:49:51.000Z",
                  "created_date__v" : "2018-04-14T15:49:51.000Z",
                  "custom_key_vid_key__v" : "CUSTOMER__v/3/change_request:HCO:932241745093790303"
               },
               {
                  "custom_key_entity_id__v" : "932241745093790303",
                  "custom_key_entity_type__v" : "HCO",
                  "custom_key_status__v" : "A",
                  "custom_key_source_type__v" : "WORKFLOW__v",
                  "custom_key_value__v" : "932241745037891103",
                  "modified_date__v" : "2018-04-14T15:49:51.000Z",
                  "vid__v" : "932241745112009311",
                  "custom_key_item_type__v" : "DCRID__v",
                  "custom_key_vid_key__v" : "WORKFLOW__v:DCRID__v:932241745037891103",
                  "created_date__v" : "2018-04-14T15:49:51.000Z",
                  "status_update_time__v" : "2018-04-14T15:49:51.000Z"
               }
            ],
            "vid__v" : "932241745093790303",
            "hco_type__v" : "4:15",
            "modified_date__v" : "2018-04-14T15:50:18.000Z",
            "record_delta_id__v" : "932241746865717247",
            "corporate_name__v" : "Mac Healthcare",
            "accept_medicare__v" : "N",
            "kaiser__v" : "N",
            "major_class_of_trade__v" : "4",
            "licenses__v" : [],
            "accept_medicaid__v" : "N",
            "is_externally_mastered__v" : false,
            "ama_do_not_contact__v" : "N",
            "record_owner_type__v" : "LOCAL",
            "lab_services__v" : "N"
         }
      }
   ]
}

Associate custom key to HCO

This API enables you to submit external key identifiers when new HCOs are downloaded from Network without going through the full change request process. This API associates the external identifier you submit to the HCO vid_key you provide.

This API requires system administrator or API-only permissions.

Endpoint URL

https://DNS/api/version/hcos/vid_key/custom_keys

DNS - is the URL for your API service
version - is the API version
vid_key - The key of the entity to add the new key to.

Parameters
custom_key_source_type: The source of the new key.
custom_key_item_type: The item type for the new key.
custom_key_value: The value for the new key.
system_name: The name of the system for the key.

Response
responseStatus: The status of the response.

Notes

responseStatus returns a failure if any standard errors occur or:

The vid_key does not represent an existing entity.
The entity specified by vid_key is not an existing HCO.
The key specified is already in use by another entity.

Changelog

Version 3.0 added the system_name parameter.

curl -X POST -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/hcos/Network:Entity:932241745093790303/custom_keys/?custom_key_source_type=HCO&custom_key_item_type=account&custom_key_value=12345'

{ 
   "responseStatus":"SUCCESS"
}

Associate custom key to a child object

This API enables you to submit external key identifiers when new HCO child objects (addresses, licenses, parent HCOs,) are downloaded from Network without going through the full change request process. This API associates the external identifier you submit to the child object key you provide.

This API requires system administrator or API-only permissions.

Endpoint URL

https://DNS/api/version/hcos/vid_key/child_object/child_key/custom_keys

DNS - is the URL for your API service
version - is the API version
vid_key - The key of the entity to add the new key to.
child_object - A Network child object (address, license, parent HCO). Use one of the following values:
- addresses - Associate custom key with addresses.
- licenses - Associate custom key with licenses.
- parent_hcos - Associate custom key with parent HCOs.
child_key - The key of the child object to add the new key to.

Parameters
custom_key_source_type: The source of the new key.
custom_key_item_type: The item type for the new key.
custom_key_value: The value for the new key.
system_name: The name of the system for the key.

Response
responseStatus: The status of the response.

Notes

The following conditions return a failed response:

The vid_key or child object key do not represent an existing entity.
The entity specified by vid_key is not an existing HCO.
The entity specified by the child object key does not represent that child object type.
The keys specified are already in use by another entity.

curl -X POST -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/hcos/Network:Entity:932241745093790303/addresses/Network:Address:932241745093790304/custom_keys?custom_key_source_type=HCO&custom_key_item_type=account&custom_key_value=54321'

curl -X POST -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/hcos/Network:Entity:932241745093790303/licenses/Network:License:937863645093876993/custom_keys?custom_key_source_type=HCO&custom_key_item_type=account&custom_key_value=54321'

curl -X POST -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/hcos/Network:Entity:932241745093790303/parent_hcos/Network:ParentHCO:987394745093668309/custom_keys?custom_key_source_type=HCO&custom_key_item_type=child&custom_key_value=54321'

{
  "responseStatus":"SUCCESS"
}

Health care professional

The health care professional API enable you to retrieve HCP information and associate custom keys with or disassociate them from other entities.

Retrieve HCP

This API enables you to retrieve information about an HCP including the HCP itself, address, license, and parent HCO information (including their custom keys) for the HCP vid_key you provide.

This API downloads the record for the specified entity from Veeva OpenData to your customer instance.

Endpoint URL

https://{DNS}/api/{version}/hcps/{vid_key}

DNS is the URL for your API service
version is the API version
vid_key is the key of the hcp to retrieve

Optional parameters
systemName: When provided, Network returns target alias values defined for reference codes for this system. Otherwise, Network returns default reference code values.
enrichedResults: Specifies whether or not to display labels for reference type fields in the results.
resultLanguage: Specifies the language to use if the enriched results option is enabled. Uses the IETF BCP 47 language standard.
returnHashtagsForType: Return hashtags for the requested type using the following values:
NETWORK - Display predefined Network hashtags.
ALL - Display Network-defined and custom hashtags.
NONE - Do not display hashtags.

Response
entities: An array of fields and values for each entity.
entityId - The entity ID.
entityType - The entity type.
metaData - Included for structure only; not applicable for this call.
entity - The fields and corresponding values for the entity.
responseStatus: The status of the response in Network.
hashtags: The list of hashtags available to the authenticated API user:
name - the hashtag name.
color - the hashtag color.
tooltip - the tooltip of the hashtag.
tooltipLabel - the field value label of the hashtag.
tooltipValue - the field value of the hashtag.
tooltipHasOtherValue - Returns True if the tooltip has more than three field values.

Notes

Following a retrieve entity call, Network returns all resource information, including custom keys.
The information returned does not include attributes with NULL values.
Network-specific fields are returned regardless of region.

Changelog

Version 19.0 added the enrichedResults and resultLanguage parameters.
Version 25.0 added the returnHashtagsForType parameter.

curl -X GET -H "Authorization: 57696C6C205261...6368204A6F7368" https://my.veevanetwork.com/api/v33.0/hcps/Network:Entity:932671707694238303

{
   "entities" : [
      {
         "metaData" : {},
         "entity" : {
            "specialty_1__v" : "AC",
            "is_externally_mastered__v" : false,
            "vid__v" : "932671707694238303",
            "licenses__v" : [
               {
                  "record_state__v" : "VALID",
                  "modified_date__v" : "2018-06-29T14:15:02.000Z",
                  "address_vid__v" : "932671707694238304",
                  "is_veeva_master__v" : false,
                  "license_status_condition__v" : "0",
                  "license_subtype__v" : "U",
                  "record_owner_name__v" : "Local",
                  "effective_date__v" : "2010-05-05",
                  "primary_license__c" : "U",
                  "license_number__v" : "1256987",
                  "status_update_time__v" : "2018-06-29T14:15:00.000Z",
                  "record_owner_type__v" : "LOCAL",
                  "body__v" : "ALMD",
                  "vid__v" : "932671707694238305",
                  "entity_type__v" : "HCP",
                  "entity_vid__v" : "932671707694238303",
                  "expiration_date__v" : "2013-12-31",
                  "license_status__v" : "A",
                  "record_delta_id__v" : "932671707821604865",
                  "created_date__v" : "2018-06-29T14:15:00.000Z",
                  "custom_keys__v" : []
               }
            ],
            "record_version__v" : 1,
            "fellow__v" : "N",
            "hcp_status__v" : "A",
            "record_owner_type__v" : "LOCAL",
            "addresses__v" : [
               {
                  "premise_number__v" : "326",
                  "thoroughfare_trailing_type__v" : "DR",
                  "thoroughfare__v" : "Harolds DR",
                  "delivery_address_1__v" : "326 Harolds DR",
                  "premise__v" : "326",
                  "address_status__v" : "A",
                  "record_owner_type__v" : "LOCAL",
                  "locality__v" : "BISMARCK",
                  "longitude__v" : -100.774784,
                  "is_veeva_master__v" : false,
                  "delivery_address__v" : "326 Harolds DR",
                  "address_line_1__v" : "326 Harolds Drive",
                  "modified_date__v" : "2018-06-29T14:15:02.000Z",
                  "ISO_3166_3__v" : "USA",
                  "address_type__v" : "P",
                  "custom_keys__v" : [],
                  "created_date__v" : "2018-06-29T14:15:00.000Z",
                  "latitude__v" : 46.815034,
                  "address_verification_status__v" : "DS",
                  "record_delta_id__v" : "932671707821604864",
                  "thoroughfare_name__v" : "Harolds",
                  "formatted_address__v" : "326 Harolds DR BISMARCK ND 58501",
                  "entity_type__v" : "HCP",
                  "entity_vid__v" : "932671707694238303",
                  "ISO_3166_n__v" : "840",
                  "vid__v" : "932671707694238304",
                  "postal_code_primary__v" : "58501",
                  "country__v" : "US",
                  "postal_code__v" : "58501",
                  "status_update_time__v" : "2018-06-29T14:15:00.000Z",
                  "administrative_area__v" : "US-ND",
                  "record_owner_name__v" : "Local",
                  "address_ordinal__v" : 1,
                  "record_state__v" : "VALID"
               }
            ],
            "status_update_time__v" : "2018-06-29T14:15:00.000Z",
            "is_veeva_master__v" : false,
            "email_1__v" : "andrew.mcelroy@hotmail.com",
            "last_name__v" : "PbLuobGIefdQCNtvQ8ZsViU3t",
            "record_owner_name__v" : "Local",
            "pdrp_optout__v" : "N",
            "modified_date__v" : "2018-06-29T14:15:02.000Z",
            "first_name__v" : "cd1mhSAt7cUS6kg8NcK5oz6nF",
            "record_state__v" : "VALID",
            "kaiser__v" : "N",
            "specialty_1_rank__v" : 1,
            "custom_keys__v" : [
               {
                  "custom_key_entity_id__v" : "932671707694238303",
                  "custom_key_status__v" : "A",
                  "custom_key_entity_type__v" : "HCP",
                  "modified_date__v" : "2018-06-29T14:15:00.000Z",
                  "custom_key_value__v" : "932671707570838463",
                  "custom_key_vid_key__v" : "WORKFLOW__v:DCRID__v:932671707570838463",
                  "vid__v" : "932671707718093407",
                  "created_date__v" : "2018-06-29T14:15:00.000Z",
                  "custom_key_item_type__v" : "DCRID__v",
                  "custom_key_source_type__v" : "WORKFLOW__v",
                  "status_update_time__v" : "2018-06-29T14:15:00.000Z"
               },
               {
                  "custom_key_source_type__v" : "CUSTOMER__v/3/change_request",
                  "status_update_time__v" : "2018-06-29T14:15:00.000Z",
                  "custom_key_vid_key__v" : "CUSTOMER__v/3/change_request:HCP:932671707694238303",
                  "vid__v" : "932671707717372511",
                  "created_date__v" : "2018-06-29T14:15:00.000Z",
                  "custom_key_item_type__v" : "HCP",
                  "custom_key_entity_type__v" : "HCP",
                  "modified_date__v" : "2018-06-29T14:15:00.000Z",
                  "custom_key_value__v" : "932671707694238303",
                  "custom_key_entity_id__v" : "932671707694238303",
                  "custom_key_status__v" : "A"
               }
            ],
            "created_date__v" : "2018-06-29T14:15:00.000Z",
            "NewAlt__c" : "KP4J39SQJZC",
            "record_delta_id__v" : "932671707842248703",
            "formatted_name__v" : "John Smith",
            "gender__v" : "M",
            "grad_training__v" : "N",
            "parent_hcos__v" : [],
            "hcp_type__v" : "P",
            "primary_country__v" : "US",
            "ama_do_not_contact__v" : "N"
         },
         "entityType" : "HCP",
         "entityId" : "932671707694238303"
      }
   ],
   "responseStatus" : "SUCCESS"
}

curl -X GET -H "Authorization: 57696C6C205261...6368204A6F7368" https://my.veevanetwork.com/api/v33.0/hcps/Network:Entity:243223879743439872?returnHashtagsForType=ALL

{
  "responseStatus": "SUCCESS",
  "entities": [
    {
      "entityId": "243223879743439872",
      "entityType": "HCP",
      "metaData": {},
      "entity": {
        "first_name__v": "April",
        ...
        "parent_hcos__v": [
          {
            "parent_hco_vid__v": "933083005204499295",
            ...
           
            ]
          }
        ]
      },
      "hashtags": [
        {
          "name": "#npi",
          "color": "gray",
          "tooltip": "HCP or HCO has an NPI number",
          "tooltipLabel": "NPI: ",
          "tooltipValue": "1316006166",
          "tooltipHasOtherValue": false
        },
        {
          "name": "#md",
          "color": "gray",
          "tooltip": "HCP has a Doctor of Medicine",
          "tooltipLabel": null,
          "tooltipValue": null,
          "tooltipHasOtherValue": false
        },
        {
          "name": "#physician",
          "color": "gray",
          "tooltip": "HCP is a physician",
          "tooltipLabel": "Degrees: ",
          "tooltipValue": "Doctor of Medicine",
          "tooltipHasOtherValue": false
        },
        {
          "name": "#ServiceCloud",
          "color": "gray",
          "tooltip": "Account was added to Service Cloud",
          "tooltipLabel": "Service Cloud Account ID:",
          "tooltipValue": "21921521512",
          "tooltipHasOtherValue": false
        }
      ]
    }
  ]
}

Associate custom key to HCP

This API enables you to submit external key identifiers when new HCPs are downloaded from Network without going through the full change request process. This API associates the external identifier you submit to the HCP vid_key you provide.

This API requires system administrator or API-only permissions.

Endpoint URL

https://DNS/api/version/hcps/vid_key/custom_keys

DNS - is the URL for your API service
version - is the API version
vid_key - The key of the entity to add the new key to.

Parameters
custom_key_source_type: The source of the new key.
custom_key_item_type: The item type for the new key.
custom_key_value: The value for the new key.
system_name: The name of the system for the key.

Response
responseStatus: The status of the response.

Notes

responseStatus returns a failure if any standard errors occur or:

The vid_key does not represent an existing entity.
The entity specified by vid_key is not an HCP.
The key specified is already in use by another entity.

Changelog

Version 3.0 added the system_name parameter.

curl -X POST -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/hcps/Network:Entity:932671707694238303/custom_keys/?custom_key_source_type=HCP&custom_key_item_type=account&custom_key_value=12345'

{ 
   "responseStatus":"SUCCESS"
}

Associate custom key to a child object

This API enables you to submit external key identifiers when new HCP child objects (addresses, licenses, parent HCOs,) are downloaded from Network without going through the full change request process. This API associates the external identifier you submit to the child object key you provide.

This API requires system administrator or API-only permissions.

Endpoint URL

https://DNS/api/version/hcps/vid_key/child_object/child_key/custom_keys

DNS - is the URL for your API service
version - is the API version
vid_key - The key of the entity to add the new key to.
child_object - A Network child object (address, license, parent HCO). Use one of the following values:
- addresses - Associate custom key with addresses.
- licenses - Associate custom key with licenses.
- parent_hcos - Associate custom key with parent HCOs.
child_key - The key of the child object to add the new key to.

Parameters
custom_key_source_type: The source of the new key.
custom_key_item_type: The item type for the new key.
custom_key_value: The value for the new key.
system_name: The name of the system for the key.

Response
responseStatus: The status of the response.

Notes

The following conditions return a failed response:

The vid_key or child object key do not represent an existing HCP.
The entity specified by vid_key is not an HCP.
The entity specified by the child object key does not represent that child object type.
The keys specified are already in use by another entity.

curl -X POST -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/hcps/Network:Entity:932671707694238303/addresses/Network:Address:939836675093779544/custom_keys?custom_key_source_type=HCP&custom_key_item_type=account&custom_key_value=54321'

curl -X POST -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/hcps/Network:Entity:932671707694238303/licenses/Network:License:999856675099568633/custom_keys?custom_key_source_type=HCP&custom_key_item_type=account&custom_key_value=54321'

curl -X POST -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/hcps/Network:Entity:932671707694238303/parent_hcos/Network:ParentHCO:987394745093668309/custom_keys?custom_key_source_type=HCP&custom_key_item_type=child&custom_key_value=54321'

{
  "responseStatus":"SUCCESS"
}

Retrieve metadata

Metadata enables you to retrieve summary and detailed information about fields, field groups. object types, and reference data. You can also retrieve summary information about each available Network API version.

Retrieve available API versions

This enables you to retrieve summary information about each API version available in Network.

Endpoint URL

https://{DNS}/api

DNS is the URL for your API service

This API takes no parameters.

Response
responseStatus: The status of the response from Network.
values: An array of values containing each available version and the version-specific API URL information.

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" https://my.veevanetwork.com/api

{
   "values": {
      "v1.0": "https://my.network.com/api/v1.0",
      "v2.0": "https://my.network.com/api/v2.0",
      "v3.0": "https://my.network.com/api/v3.0",
      "v4.0": "https://my.network.com/api/v4.0",
      "v5.0": "https://my.network.com/api/v5.0",
      "v6.0": "https://my.network.com/api/v6.0",
      "v7.0": "https://my.network.com/api/v7.0",
      "v8.0": "https://my.network.com/api/v8.0",
      "v9.0": "https://my.network.com/api/v9.0",
      "v10.0": "https://my.network.com/api/v10.0",
      "v11.0": "https://my.network.com/api/v11.0",
      "v12.0": "https://my.network.com/api/v12.0",
      "v13.0": "https://my.network.com/api/v13.0",
      "v14.0": "https://my.network.com/api/v14.0",
      "v15.0": "https://my.network.com/api/v15.0",
      "v16.0": "https://my.network.com/api/v16.0",
      "v17.0": "https://my.network.com/api/v17.0",
      "v18.0": "https://my.network.com/api/v18.0",
      "v19.0": "https://my.network.com/api/v19.0",
      "v20.0": "https://my.network.com/api/v20.0",
      "v21.0": "https://my.network.com/api/v21.0",
      "v22.0": "https://my.network.com/api/v22.0",
      "v23.0": "https://my.network.com/api/v23.0",
      "v24.0": "https://my.network.com/api/v24.0",
      "v25.0": "https://my.network.com/api/v25.0",
      "v26.0": "https://my.network.com/api/v26.0",
      "v27.0": "https://my.network.com/api/v27.0",
      "v28.0": "https://my.network.com/api/v28.0",
      "v29.0": "https://my.network.com/api/v29.0",
      "v30.0": "https://my.network.com/api/v30.0",
      "v31.0": "https://my.network.com/api/v31.0",
      "v32.0": "https://my.network.com/api/v32.0"
    },
    "responseStatus": "SUCCESS"
}

Retrieve hashtags

This API enables you to retrieve the list of hashtags available in a Network instance.

Endpoint URL

https://{DNS}/api/{version}/metadata/hashtags

DNS is the URL for your API service
version is the API version

Optional parameters
returnHashtagsForType: Return hashtags for the requested type using the following values:
NETWORK - Display predefined Network hashtags.
CRM - Display hashtags specific to Veeva CRM.
ALL - Display Network-defined and custom hashtags.
NONE - Do not display hashtags.

Response
responseStatus: The status of the response from Network.
hashtags: The list of hashtags available to the authenticated API user:
name - the hashtag name.
color - the hashtag color.
tooltipShowFieldValue - the hashtag field value.
tooltipField - the tooltip field value.
countries - a list of countries.
entityTypes - a list of entity types.
hashtagRules - a list of rules used to determine the hashtag. Includes fieldName, fieldType, ruleCondition, value1, value2.
hashtagTooltipLocalizations: The list of tooltip localized values. Includes languageCode, description, and fieldValue.
hashtagVisibilities: The list of hashtag visibility rules. Includes:
type: ALL, NONE, NETWORK, WIDGET.
subtype: SEARCH_AND_DOWNLOAD, PROFILE, MY_REQUESTS.
value - ALL when the type is WIDGET.

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" https://my.veevanetwork.com/api/v33.0/metadata/hashtags

{
  "responseStatus": "SUCCESS",
  "hashtags": [
    {
      "name": "#npi",
      "color": "gray",
      "tooltipShowFieldValue": true,
      "tooltipField": "npi_num__v",
      "countries": [
        "US"
      ],
      "entityTypes": [
        "HCP",
        "HCO"
      ],
      "hashtagRules": [
        {
          "fieldName": "hcp.npi_num__v",
          "fieldType": "STRING",
          "ruleCondition": "is_not_null",
          "value1": null,
          "value2": null
        },
        {
          "fieldName": "hco.npi_num__v",
          "fieldType": "STRING",
          "ruleCondition": "is_not_null",
          "value1": null,
          "value2": null
        }
      ],
      "hashtagTooltipLocalizations": [
        {
          "languageCode": "EN",
          "description": "HCP or HCO has an NPI number",
          "fieldValue": "NPI: "
        }
      ],
      "hashtagVisibilities": [
        {
          "type": "NETWORK",
          "subtype": null,
          "value": "ALL"
        },
        {
          "type": "WIDGET",
          "subtype": "SEARCH_AND_DOWNLOAD",
          "value": "ALL"
        },
        {
          "type": "WIDGET",
          "subtype": "PROFILE",
          "value": "ALL"
        },
        {
          "type": "WIDGET",
          "subtype": "MY_REQUESTS",
          "value": "ALL"
        }
      ]
    }
   ]
}

Retrieve languages

This API enables you to retrieve the list of reference data languages available in a Network instance.

Endpoint URL

https://{DNS}/api/{version}/metadata/languages

DNS is the URL for your API service
version is the API version

This API takes no parameters.

Response
responseStatus: The status of the response from Network.
languages: A list of the supported reference data languages that are organized by lowest ordinal value.
When new languages are added to Network, they are appended as a new column in the reference.csv file for target subscriptions. AlternateName is used as the column headers and alternateOrdinal determines the order of the language columns.

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" https://my.veevanetwork.com/api/v33.0/metadata/languages

{
    "responseStatus": "SUCCESS",
    "languages": [
        {
            "name": "en",
            "alternateName": "EN",
            "alternateOrdinal": 1,
            "associatedLocale": "en_US"
        },
        {
            "name": "zh",
            "alternateName": "ZH",
            "alternateOrdinal": 2,
            "associatedLocale": "zh_CN"
        },
        {
            "name": "fr",
            "alternateName": "FR",
            "alternateOrdinal": 3,
            "associatedLocale": "fr_FR"
        }
        ...
    ]
}

Retrieve object types metadata

This API enables you to retrieve the list of object types available in Network.

Endpoint URL

https://{DNS}/api/{version}/metadata/objectTypes

DNS is the URL for your API service
version is the API version

Optional parameters
owner: filter objects by customer- or Veeva-owned

Response
responseStatus: The status of the response from Network.
objectTypes: An array of attribute information objects:
name - the entity name (HCP, HCO, ADDRESS, LICENSE, PARENTHCO, CUSTOMKEY)
description - Localized text description of the entity
status - returns all types regardless of the status
customerDefined - True for custom objects, otherwise False.
type - *object*, *sub-object*, or *relationship*

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" https://my.veevanetwork.com/api/v33.0/metadata/objectTypes

{
   "responseStatus" : "SUCCESS",
   "objectTypes" : [
      {
         "description" : "Health Care Professional",
         "type" : "object",
         "status" : "ACTIVE",
         "customer_defined" : false,
         "name" : "HCP"
      },
      {
         "description" : "Health Care Organization",
         "type" : "object",
         "name" : "HCO",
         "customer_defined" : false,
         "status" : "ACTIVE"
      },
      {
         "description" : "Address",
         "type" : "sub-object",
         "customer_defined" : false,
         "status" : "ACTIVE",
         "name" : "ADDRESS"
      },
      {
         "name" : "LICENSE",
         "status" : "ACTIVE",
         "customer_defined" : false,
         "type" : "sub-object",
         "description" : "License"
      },
      {
         "type" : "relationship",
         "description" : "Parent HCO",
         "name" : "PARENTHCO",
         "customer_defined" : false,
         "status" : "ACTIVE"
      },
      {
         "type" : "sub-object",
         "description" : "Custom Key",
         "customer_defined" : false,
         "status" : "ACTIVE",
         "name" : "CUSTOMKEY"
      },
      {
         "type": "object",
         "description": "Employee",
         "customer_defined": true,
         "status": "ACTIVE",
         "name": "EMPLOYEE__C"
      }
   ]
}

Retrieve fields metadata

This API enables you to retrieve detailed or summary information about the fields on each entity in Network.

Endpoint URL

https://{DNS}/api/{version}/metadata/fields

DNS is the URL for your API service
version is the API version

Optional parameters
objectTypes: Filter fields to those applicable for certain object types:
Default - do not filter by object type.
Values - comma-separated list of object types from: HCP, HCO, LICENSE, ADDRESS, PARENTHCO, CUSTOMKEY
owner: Filter fields to those owned by the specified party:
Default - do not filter by owner
Values - veeva (maintained by Veeva), customer (created and managed by the customer)
details: Include field details:
Default - Only returns field IDs
Value - full (include field details in the results)
labels: Include labels in field details:
Default - Include labels
Values - True or empty (include labels in the field details in the results)
fieldGroup: Filter fields to those applicable for a certain field group:
Default - do not filter by field group
Values - The desired field group, for example, credentials, medical_degree, and so on
country: Filter fields by country visibility:
Default - do not filter by country
Values - The desired country value, for example, US, GB, FR. The country must be visible to the authenticated user.
countries: Filter fields by country visibility:
Default - do not filter by country
Values - The desired country values, for example, US, GB, FR. The countries must be visible to the authenticated user.

Response
responseStatus: The status of the response from Network.
attributes: An array attribute of information objects:
field_id - The ID of the field; for example, first_name__v.
type:
dataType - The type object, containing two attributes:
VEEVAID - the Veeva ID
STRING - text
YEAR - year value (no month or day)
DATE - date (no time)
DATETIME - date + Time (timestamp)
NUMBER - integer number
DOUBLE - floating point number
BOOLEAN - True or False value
REFERENCE - reference code
SET - a collection of values
ALTERNATEKEY - an alternate key
discriminator - For reference data type, include the reference data type name
labels: Set of language to description pairs (unless labels is not equal to True or empty).
customerOwned: True if this is a custom field, otherwise False.
description: Non-localized text description of field.
readOnly: True if this is a read-only attribute, False otherwise.
ownerOnlyEdit: True if this attribute can only be edited when owned by the customer. Cannot modify these attributes in Veeva OpenData records.
status: One of ACTIVE, DELETED, or DEACTIVATED.
fieldGroup: Either null or the name of the group for this attribute.
fieldSet: Either null or the name of the field set for this attribute.
sinceVersion: The Network version of when the attribute was released, for example, 1.0.0 or 1.5.2.
maximumLength: The recommended maximum length for this attribute.
required: True if this is a required attribute, False otherwise.
blankAllowed: True if this attribute can be blank, False otherwise.
defaultValue: The default value of this attribute.
expression: NEX (Network Expression) rule that is evaluated to determine the value of this attribute
expressionFlags: Bitwise OR of flags that describe when the expression is evaluated (1=evaluate on any value change, 2=evaluate on any attribute value change, 4=evaluate only if current value is not set)
dataPrivacyFlag: The value that will be included in fields when the HCP record is marked as opted out. Current values:
NONE - No data privacy is applied to the field.
MASK_WITH_BLANK - The field value is replaced with a blank or null.
MASK_WITH_LABEL - The field value is replaced with a localized label: Data Privacy/Client Data Privacy
countries: The country code. Current values:
available - a True/False value that indicates whether the field is available for a particular country
required - a True/False value that indicates whether the field is required when creating a new record for a particular country
readOnly - a True/False value that indicates whether the field is read-only for a particular country
defaultValue - a True/False value that indicates the default value if NULL is provided when creating a new record for a particular country
expression - NEX (Network Expression) rule that is evaluated to determine the value of this attribute
expressionFlags - bitwise OR of flags that describe when the expression is evaluated (1=evaluate on any value change, 2=evaluate on any attribute value change, 4=evaluate only if current value is not set)
allowedObjectTypes - an array of allowed types (from HCP, HCO, ADDRESS, LICENSE, PARENTHCO, CUSTOMKEY) for a particular country
changeProcedure: This field replaces the deprecated changeRequest flag. This value can be configured per region and entity. For each of defaultChangeProcedure (default change procedure for the attribute) and regionalChangeProcedures (change procedures per region), the current values are as follows:
DEFAULT - let the system decide what to do
ALWAYS_ACCEPT_CHANGE - any changes will be automatically accepted without data steward review
ALWAYS_REVIEW - any changes to this field must be reviewed by a data steward

Notes

The response HTTP header includes Last-Modified to indicate the date when the list of fields was last changed.
Supports the HTTP request header If-Modified-Since to check if the list of fields was modified since the specified date. The HTTP response contains the status code of 304 Not Modified if the content is unchanged.

Changelog

Version 3.0 response includes required, blankAllowed, defaultValue, country.
Version 4.0 inclues the countries parameter.
Version 5.0 response includes expression and expressionFlags for attributes and countries.
Version 6.0 response includes the data privacy flag for attributes.

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" https://my.veevanetwork.com/api/v33.0/metadata/fields?objectTypes=license

{
   "attributes" : [
      "address_vid__v",
      "address_vid_key",
      "anticipated_expiry_date__v",
      "best_state_license__v",
      "body__v",
      "created_date__v",
      "custom_keys__v",
      "dea_business_activity_code__v",
      "dea_payment_indicator__v",
      "drug_schedule__v",
      "effective_date__v",
      "entity_type__v",
      "entity_vid__v",
      "expiration_date__v",
      "grace_period__v",
      "initial_board_license_date__v",
      "is_externally_mastered__v",
      "is_proprietary__v",
      "is_veeva_master__v",
      "license_admin_area__v",
      "license_certification__v",
      "license_degree__v",
      "license_eligibility__v",
      "license_number__v",
      "license_status__v",
      "license_status_condition__v",
      "license_subtype__v",
      "licensing_body__v",
      "modified_date__v",
      "record_delta_id__v",
      "record_merged_vid__v",
      "record_owner_name__v",
      "record_owner_type__v",
      "record_state__v",
      "rxa_eligible__v",
      "source_address__v",
      "status_update_time__v",
      "type__v",
      "type_value__v",
      "vid__v"
   ],
   "responseStatus" : "SUCCESS"
}

Retrieve field details metadata

This API enables you to retrieve detailed information about the fields on each entity in Network.

Endpoint URL

https://{DNS}/api/{version}/metadata/fields/{field_ids}

DNS is the URL for your API service
version is the API version
field_ids is a comma-separated list of field IDs to look up

Optional parameters
labels: Include labels in field details:
Default - Include labels
Values - True or empty (include labels in the field details in the results)
countries: Filter fields by country visibility:
Default - do not filter by country
Values - The desired country values, for example, US, GB, FR. The countries must be visible to the authenticated user.

Response
responseStatus: The status of the response from Network.
attributes: An array attribute of information objects:
field_id - The ID of the field; for example, first_name__v.
type:
dataType - The type object, containing two attributes:
VEEVAID - the Veeva ID
STRING - text
YEAR - year value (no month or day)
DATE - date (no time)
DATETIME - date + Time (timestamp)
NUMBER - integer number
DOUBLE - floating point number
BOOLEAN - True or False value
REFERENCE - reference code
SET - a collection of values
ALTERNATEKEY - an alternate key
discriminator - For reference data type, include the reference data type name
labels: Set of language to description pairs (unless labels is not equal to True or empty).
customerOwned: True if this is a custom field, otherwise False.
description: Non-localized text description of field.
readOnly: True if this is a read-only attribute, False otherwise.
ownerOnlyEdit: True if this attribute can only be edited when owned by the customer. Cannot modify these attributes in Veeva OpenData records.
status: One of ACTIVE, DELETED, or DEACTIVATED.
fieldGroup: Either null or the name of the group for this attribute.
fieldSet: Either null or the name of the field set for this attribute.
sinceVersion: The Network version of when the attribute was released, for example, 1.0.0 or 1.5.2.
maximumLength: The recommended maximum length for this attribute.
required: True if this is a required attribute, False otherwise.
blankAllowed: True if this attribute can be blank, False otherwise.
defaultValue: The default value of this attribute.
expression: NEX (Network Expression) rule that is evaluated to determine the value of this attribute
expressionFlags: Bitwise OR of flags that describe when the expression is evaluated (1=evaluate on any value change, 2=evaluate on any attribute value change, 4=evaluate only if current value is not set)
dataPrivacyFlag: The value that will be included in fields when the HCP record is marked as opted out. Current values:
NONE - No data privacy is applied to the field.
MASK_WITH_BLANK - The field value is replaced with a blank or null.
MASK_WITH_LABEL - The field value is replaced with a localized label: Data Privacy/Client Data Privacy
countries: The country code. Current values:
available - a True/False value that indicates whether the field is available for a particular country
required - a True/False value that indicates whether the field is required when creating a new record for a particular country
readOnly - a True/False value that indicates whether the field is read-only for a particular country
defaultValue - a True/False value that indicates the default value if NULL is provided when creating a new record for a particular country
expression - NEX (Network Expression) rule that is evaluated to determine the value of this attribute
expressionFlags - bitwise OR of flags that describe when the expression is evaluated (1=evaluate on any value change, 2=evaluate on any attribute value change, 4=evaluate only if current value is not set)
allowedObjectTypes - an array of allowed types (from HCP, HCO, ADDRESS, LICENSE, PARENTHCO, CUSTOMKEY) for a particular country
multivalued: For reference data fields, returns true or false to indicate whether they are multiple value reference fields. For all other field types, null is returned.

Changelog

Version 3.0 response includes required, blankAllowed, defaultValue.
Version 4.0 inclues the countries parameter.
Version 5.0 response includes expression and expressionFlags for attributes and countries.
Version 6.0 response includes the data privacy flag for attributes.

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/metadata/fields/academic_title__v'

{
   "attributes" : [
      {
         "customerOwned" : false,
         "sinceVersion" : "1.0.0",
         "required" : false,
         "changeProcedure" : {
            "defaultChangeProcedure" : {
               "changeRequestFlags" : {
                  "HCP" : "DEFAULT"
               }
            },
            "regionalChangeProcedures" : {}
         },
         "maximumLength" : 100,
         "labels" : {
            "zh" : "学术职务",
            "es" : "Título académico",
            "pt-BR" : "Título acadêmico",
            "tr" : "Akademik Ünvan",
            "fr" : "Titre de formation",
            "zh_HK" : "學術職務",
            "en" : "Academic Title",
            "pt" : "Título académico",
            "nl" : "Academische titel",
            "de" : "Akademischer Titel",
            "it" : "Titolo accademico",
            "ja" : "大学職位"
         },
         "expressionFlags" : 0,
         "fieldId" : "academic_title__v",
         "ownerOnlyEdit" : false,
         "fieldGroup" : null,
         "countries" : {
            "AU" : {
               "required" : false,
               "expression" : null,
               "country" : "AU",
               "allowedObjectTypes" : [],
               "available" : false,
               "defaultValue" : null,
               "expressionFlags" : 0,
               "readOnly" : false
            },
            "IE" : {
               "country" : "IE",
               "required" : false,
               "expression" : null,
               "readOnly" : false,
               "expressionFlags" : 0,
               "allowedObjectTypes" : [],
               "defaultValue" : null,
               "available" : false
            },
            "NZ" : {
               "allowedObjectTypes" : [],
               "available" : false,
               "defaultValue" : null,
               "expressionFlags" : 0,
               "readOnly" : false,
               "expression" : null,
               "required" : false,
               "country" : "NZ"
            },
            "FR" : {
               "available" : false,
               "defaultValue" : null,
               "allowedObjectTypes" : [],
               "expressionFlags" : 0,
               "readOnly" : false,
               "required" : false,
               "expression" : null,
               "country" : "FR"
            },
            "BR" : {
               "expressionFlags" : 0,
               "readOnly" : false,
               "available" : true,
               "defaultValue" : null,
               "allowedObjectTypes" : [
                  "HCP"
               ],
               "country" : "BR",
               "required" : false,
               "expression" : null
            },
            "JP" : {
               "expressionFlags" : 0,
               "readOnly" : false,
               "allowedObjectTypes" : [],
               "available" : false,
               "defaultValue" : null,
               "country" : "JP",
               "expression" : null,
               "required" : false
            },
            "CN" : {
               "country" : "CN",
               "expression" : null,
               "required" : false,
               "readOnly" : false,
               "expressionFlags" : 0,
               "defaultValue" : null,
               "available" : true,
               "allowedObjectTypes" : [
                  "HCP"
               ]
            },
            "DE" : {
               "readOnly" : false,
               "expressionFlags" : 0,
               "defaultValue" : null,
               "available" : true,
               "allowedObjectTypes" : [
                  "HCP"
               ],
               "country" : "DE",
               "required" : false,
               "expression" : null
            },
            "GB" : {
               "expressionFlags" : 0,
               "readOnly" : false,
               "allowedObjectTypes" : [],
               "available" : false,
               "defaultValue" : null,
               "country" : "GB",
               "expression" : null,
               "required" : false
            },
            "IT" : {
               "country" : "IT",
               "expression" : null,
               "required" : false,
               "expressionFlags" : 0,
               "readOnly" : false,
               "available" : false,
               "defaultValue" : null,
               "allowedObjectTypes" : []
            },
            "US" : {
               "allowedObjectTypes" : [],
               "available" : false,
               "defaultValue" : null,
               "expressionFlags" : 0,
               "readOnly" : false,
               "required" : false,
               "expression" : null,
               "country" : "US"
            }
         },
         "expression" : null,
         "blankAllowed" : true,
         "dataPrivacyFlag" : "MASK_WITH_BLANK",
         "defaultValue" : null,
         "type" : {
            "discriminator" : "HCPAcademicTitle",
            "dataType" : "REFERENCE"
         },
         "description" : "Academic Title",
         "fieldSet" : null,
         "readOnly" : false,
         "status" : "ACTIVE"
      }
   ],
   "responseStatus" : "SUCCESS"
}

Retrieve field groups metadata

This API enables you to retrieve detailed information about the field groups available in Network. These field groups are used by the CRM bridge when retrieving and displaying information from Network in CRM.

Endpoint URL

https://{DNS}/api/{version}/metadata/fieldGroups

DNS is the URL for your API service
version is the API version

This API takes no parameters.

Response
responseStatus: The status of the response from Network.
fieldGroups: An array of field groups.

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/metadata/fieldGroups'

{
   "fieldGroups" : [
      "credentials",
      "medical_degree",
      "specialty"
   ],
   "responseStatus" : "SUCCESS"
}

Retrieve reference data types metadata

This API enables you to retrieve information about reference data types in Network.

Endpoint URL

https://{DNS}/api/{version}/metadata/reference_values

DNS is the URL for your API service
version is the API version

Optional parameters
owner: Filter reference types to those owned by the specified party:
Default - do not filter by owner
Values - veeva (maintained by Veeva), customer (created and managed by customer)
inactive: Include reference codes marked as inactive:
Default - do not include inactive reference codes
Values - True (include inactive reference codes in the results), otherwise do not include inactive reference codes. This value only works when includeCodes is True.
includeCodes: Include reference codes details:
Default - return only type, base English label, and description
Values - True (include reference codes in the results), otherwise do not include reference codes. If True, the codes returned are filtered by the inactive and owner parameters.
country: Filter codes by country, only if includeCodes is True:
Default - do not filter by country
Values - The desired country value, for example, US, GB, FR. The country must be visible to the authenticated user.
countries: Filter fields by country visibility:
Default - do not filter by country
Values - The desired country values, for example, US, GB, FR. The countries must be visible to the authenticated user.
systemName: Return target alias values specified for reference value codes for this system:
Default - return the default reference value codes

Response
responseStatus: The status of the response from Network.
reference_type_values: A single object containing information on the type and its codes:
type - The reference type name, for example, Country.
customerOwned - True if this is a customer created reference type, False otherwise.
inactive - True if this reference type has been inactivated.
description - Non-localized text description of the reference type.
reference_type_codes- Array of reference code objects if includeCodes is True:
type - the reference type value of the code, for example, Country
code - the reference code value
values - an array of language/value pairs. Each reference item has its textual value provided in a set of translations. This array can be used to determine which languages are supported and the value for each language. For example: [{"en":"Canada"},{"zh":"加拿大"},{"fr":"Canada"},{"de":"Kanada"}]. Language codes are IETF language tags.
customerOwned - True if this is a customer created reference code, False otherwise
inactive - True if this reference type has been inactivated
countries - list of countries for which the code is visible, for example, US or GB.

Notes

The response HTTP header includes Last-Modified to indicate the date when the list of fields was last changed.
Supports the HTTP request header If-Modified-Since to check if the list of fields was modified since the specified date. The HTTP response contains the status code of 304 Not Modified if the content is unchanged.

Changelog

Version 4.0 includes the countries parameter.

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/metadata/reference_values'

{
   "responseStatus" : "SUCCESS",
   "reference_type_values" : [
      {
         "inactive" : false,
         "type" : "AddressAdminArea",
         "description" : "AddressAdminArea",
         "customerOwned" : false
      },
      {
         "description" : "Core Based Statistical Area",
         "type" : "AddressCBSA",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "type" : "AddressClusterLevelLabel",
         "description" : "Cluster Management Level Labels",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "type" : "AddressClusterProvider",
         "description" : "Cluster Providers",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "type" : "AddressClusterProviderVersion",
         "description" : "Cluster Provider Version"
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "type" : "AddressClusterStatus",
         "description" : "Cluster Management Status"
      },
      {
         "description" : "AddressCountry",
         "type" : "AddressCountry",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "inactive" : false,
         "description" : "AddressDPVConfIndicator",
         "type" : "AddressDPVConfIndicator",
         "customerOwned" : false
      },
      {
         "description" : "AddressDPVFootnotes",
         "type" : "AddressDPVFootnotes",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "type" : "AddressFootnotes",
         "description" : "AddressFootnotes",
         "inactive" : false
      },
      {
         "inactive" : false,
         "description" : "AddressISO31663",
         "type" : "AddressISO31663",
         "customerOwned" : false
      },
      {
         "inactive" : false,
         "type" : "AddressISO3166n",
         "description" : "AddressISO3166n",
         "customerOwned" : false
      },
      {
         "inactive" : false,
         "description" : "AddressRecordType",
         "type" : "AddressRecordType",
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "type" : "AddressReturnCode",
         "description" : "AddressReturnCode"
      },
      {
         "customerOwned" : false,
         "description" : "AddressStatus",
         "type" : "AddressStatus",
         "inactive" : false
      },
      {
         "description" : "Is this a mail or professional address or both",
         "type" : "AddressType",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "inactive" : false,
         "type" : "AddressVerificationStatus",
         "description" : "AddressVerificationStatus",
         "customerOwned" : false
      },
      {
         "description" : "The direction of the affiliation between the two affiliated entities",
         "type" : "AffiliationDirection",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "description" : "The line thickness between the two affiliated entities",
         "type" : "AffiliationStrength"
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "type" : "BooleanReference",
         "description" : "Boolean Values"
      },
      {
         "description" : "High level description of the type of job or position that a Health Care Provider has at a Health Care Organization.",
         "type" : "ClassOfWork",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "customerOwned" : true,
         "description" : "CM20567",
         "type" : "CommsTitleSOBI__c",
         "inactive" : false
      },
      {
         "description" : "CSRVariationType",
         "type" : "CSRVariationType",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "inactive" : false,
         "type" : "Currency",
         "description" : "Currency",
         "customerOwned" : false
      },
      {
         "inactive" : false,
         "type" : "DepartmentClass",
         "customerOwned" : false
      },
      {
         "description" : "EnrollmentOptions",
         "type" : "EnrollmentOptions",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "description" : "Type of entities in the system",
         "type" : "EntityType",
         "inactive" : false
      },
      {
         "inactive" : false,
         "description" : "An official recognition or certification authorizing an HCO to provide a certain type of service",
         "type" : "HCOAccreditation",
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "type" : "HCOBusinessType"
      },
      {
         "customerOwned" : false,
         "description" : "CLIA Status",
         "type" : "HCOCLIAStatus",
         "inactive" : false
      },
      {
         "type" : "HCOEstablishedBy",
         "description" : "HCO Establishers",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "type" : "HCOFocusArea",
         "inactive" : false
      },
      {
         "customerOwned" : false,
         "type" : "HCOHospitalGrade",
         "inactive" : false
      },
      {
         "description" : "Percentage of medicaid patients in the practice",
         "type" : "HCOMedicaidPercentage",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "type" : "HCOMedicarePercentage",
         "description" : "Percentage of medicare patients in the practice",
         "inactive" : false
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "description" : "Status of HCO",
         "type" : "HCOStatus"
      },
      {
         "inactive" : false,
         "type" : "HCOType",
         "description" : "Type of HCO",
         "customerOwned" : false
      },
      {
         "type" : "HCPAcademicTitle",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "type" : "HCPBoardCertification",
         "description" : "Board Certification"
      },
      {
         "type" : "HCPConventionStatus",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "description" : "Credentials for an HCP",
         "type" : "HCPCredentials",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "description" : "Level of education for an HCP",
         "type" : "HCPEducationLevel",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "type" : "HCPFocusArea",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "inactive" : false,
         "description" : "Gender",
         "type" : "HCPGender",
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "description" : "HCPGrade",
         "type" : "HCPGrade"
      },
      {
         "customerOwned" : false,
         "type" : "HCPMajorAreaofStudy",
         "inactive" : false
      },
      {
         "customerOwned" : false,
         "description" : "Major Professional Activity",
         "type" : "HCPMajorProfActivity",
         "inactive" : false
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "type" : "HCPMedicalDegree",
         "description" : "Degrees"
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "description" : "Place of Employment",
         "type" : "HCPPlaceOfEmployment"
      },
      {
         "inactive" : false,
         "description" : "Type of practice for an HCP",
         "type" : "HCPPracticeType",
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "description" : "HCPPrefix",
         "type" : "HCPPrefix",
         "inactive" : false
      },
      {
         "inactive" : false,
         "type" : "HCPProfessionalLevel",
         "customerOwned" : false
      },
      {
         "type" : "HCPProfessionalTitle",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "type" : "HCPStatus",
         "description" : "HCP Statuses",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "type" : "HCPType",
         "description" : "HCPType"
      },
      {
         "inactive" : false,
         "type" : "KeySourceContext",
         "description" : "Key Source Context",
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "description" : "Key Statuses",
         "type" : "KeyStatus",
         "inactive" : false
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "type" : "Language",
         "description" : "Language"
      },
      {
         "inactive" : false,
         "type" : "LicenseCertification",
         "description" : "LicenseCertification",
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "description" : "License DEA Business Activity Code",
         "type" : "LicenseDEACode"
      },
      {
         "customerOwned" : false,
         "type" : "LicenseDEAPaymentIndicator",
         "description" : "Sourced from a field in the DEA file layout that identifies if payment is required or is exempt.",
         "inactive" : false
      },
      {
         "customerOwned" : false,
         "type" : "LicenseEligibility",
         "description" : "License Eligibility",
         "inactive" : false
      },
      {
         "customerOwned" : false,
         "description" : "Status of a License",
         "type" : "LicenseStatus",
         "inactive" : false
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "type" : "LicenseStatusCondition"
      },
      {
         "type" : "LicenseSubType",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "inactive" : false,
         "description" : "Type/Scope of license",
         "type" : "LicenseType",
         "customerOwned" : false
      },
      {
         "type" : "LicensingBody",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "type" : "MAHFunctionRoles__c",
         "description" : "test",
         "inactive" : false,
         "customerOwned" : true
      },
      {
         "customerOwned" : false,
         "type" : "MajorClassofTrade",
         "inactive" : false
      },
      {
         "description" : "MetalLevel",
         "type" : "MetalLevel",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "inactive" : false,
         "type" : "ParentAddressSyncReference",
         "description" : "Parent Address Sync Reference",
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "description" : "Indicates whether the record is third party owned, OpenData owned or Customer Owned.",
         "type" : "RecordOwnerType",
         "inactive" : false
      },
      {
         "description" : "State of the record in the Veeva system",
         "type" : "RecordState",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "description" : "RelationHierarchyType",
         "type" : "RelationHierarchyType",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "description" : "RelationParentType",
         "type" : "RelationParentType"
      },
      {
         "description" : "Relationship Statuses",
         "type" : "RelationStatus",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "inactive" : false,
         "type" : "RelationStatusReason",
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "type" : "RelationType",
         "description" : "RelationType"
      },
      {
         "inactive" : false,
         "type" : "SanctionCategory",
         "description" : "Sanction Categories",
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "description" : "Sanction Exclusions",
         "type" : "SanctionExclusion",
         "inactive" : false
      },
      {
         "description" : "Specialties",
         "type" : "Specialty",
         "inactive" : false,
         "customerOwned" : false
      },
      {
         "inactive" : false,
         "type" : "SpecialtyGroup",
         "description" : "List of specialty group codes",
         "customerOwned" : false
      },
      {
         "customerOwned" : false,
         "inactive" : false,
         "type" : "TraumaLevel",
         "description" : "HCO Trauma Level"
      }
   ]
}

Retrieve reference data type details metadata

This API enables you to retrieve detailed information about reference data types in Network.

Endpoint URL

https://{DNS}/api/{version}/metadata/reference_values/{type}

DNS is the URL for your API service
version is the API version
type is the specific data type to retrieve details about

Optional parameters
owner: Filter reference types to those owned by the specified party:
Default - do not filter by owner
Values - veeva (maintained by Veeva), customer (created and managed by customer)
inactive: Include reference codes marked as inactive:
Default - do not include inactive reference codes
Values - True (include inactive reference codes in the results), otherwise do not include inactive reference codes. This value only works when includeCodes is True.
country: Filter codes by country, only if includeCodes is True:
Default - do not filter by country
Values - The desired country value, for example, US, GB, FR. The country must be visible to the authenticated user.
countries: Filter fields by country visibility:
Default - do not filter by country
Values - The desired country values, for example, US, GB, FR. The countries must be visible to the authenticated user.
systemName: Return target alias values specified for reference value codes for this system:
Default - return the default reference value codes

Response
responseStatus: The status of the response from Network.
reference_type_values: A single object containing information on the type and its codes:
type - The reference type name, for example, Country.
customerOwned - True if this is a customer created reference type, False otherwise.
inactive - True if this reference type has been inactivated.
description - Non-localized text description of the reference type.
reference_type_codes- Array of reference code objects if includeCodes is True:
type - the reference type value of the code, for example, Country
code - the reference code value
values - an array of language/value pairs. Each reference item has its textual value provided in a set of translations. This array can be used to determine which languages are supported and the value for each language. For example: [{"en":"Canada"},{"zh":"加拿大"},{"fr":"Canada"},{"de":"Kanada"}]. Language codes are IETF language tags.
customerOwned - True if this is a customer created reference code, False otherwise.
inactive - True if this reference type has been inactivated
countries - list of countries for which the code is visible, for example, US or GB.

Notes

The response HTTP header includes Last-Modified to indicate the date when the list of fields was last changed.
Supports the HTTP request header If-Modified-Since to check if the list of fields was modified since the specified date. The HTTP response contains the status code of 304 Not Modified if the content is unchanged.

Changelog

Version 4.0 includes the countries parameter.

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/metadata/reference_values/Specialty'

{
  "responseStatus": "SUCCESS",
  "type": "Specialty",
  "customerOwned": false,
  "inactive": false,
  "description": "Specialties",
  "reference_type_codes": [
    {
      "type": "Specialty",
      "code": "AR",
      "values": {
        "en": "Abdominal Radiology"
      },
      "customerOwned": false,
      "inactive": false,
      "countries": [
        "US"
      ]
    },
    {
      "type": "Specialty",
      "code": "AS",
      "values": {
        "en": "Abdominal Surgery"
      },
      "customerOwned": false,
      "inactive": false,
      "countries": [
        "US"
      ]
    },
    {
      "type": "Specialty",
      "code": "ACU",
      "values": {
        "en": "Acupuncture"
      },
      "customerOwned": false,
      "inactive": false,
      "countries": [
        "US"
      ]
    },
    {
      "type": "Specialty",
      "code": "AC",
      "values": {
        "en": "Acute Care"
      },
      "customerOwned": false,
      "inactive": false,
      "countries": [
        "US"
      ]
    },
    {
      "type": "Specialty",
      "code": "ACP",
      "values": {
        "en": "Acute Care Pediatrics (APNs only)"
      },
      "customerOwned": false,
      "inactive": false,
      "countries": [
        "US"
      ]
    },
    {
      "type": "Specialty",
      "code": "ADM",
      "values": {
        "en": "Addiction Medicine"
      },
      "customerOwned": false,
      "inactive": false,
      "countries": [
        "US"
      ]
    },
    {
      "type": "Specialty",
      "code": "ADP",
      "values": {
        "en": "Addiction Psychiatry"
      },
      "customerOwned": false,
      "inactive": false,
      "countries": [
        "US"
      ]
    },
    {
      "type": "Specialty",
      "code": "PSU",
      "values": {
        "en": "Addiction Psychology & Counseling"
      },
      "customerOwned": false,
      "inactive": false,
      "countries": [
        "US"
      ]
    },
    {
      "type": "Specialty",
      "code": "AMD",
      "values": {
        "en": "Administrative Medicine"
      },
      "customerOwned": false,
      "inactive": false,
      "countries": [
        "US"
      ]
    },
    {
      "type": "Specialty",
      "code": "AMF",
      "values": {
        "en": "Adolescent Medicine (Family Medicine)"
      },
      "customerOwned": false,
      "inactive": false,
      "countries": [
        "US"
      ]
    },
    {
      "type": "Specialty",
      "code": "AMI",
      "values": {
        "en": "Adolescent Medicine (Internal Medicine)"
      },
      "customerOwned": false,
      "inactive": false,
      "countries": [
        "US"
      ]
    },
    {
      "type": "Specialty",
      "code": "ADL",
      "values": {
        "en": "Adolescent Medicine (Pediatrics)"
      },
      "customerOwned": false,
      "inactive": false,
      "countries": [
        "US"
      ]
    },
    {
      "type": "Specialty",
      "code": "CHD",
      "values": {
        "en": "Adult Congenital Heart Disease (IM)"
      },
      "customerOwned": false,
      "inactive": false,
      "countries": [
        "US"
      ]
    },
    {
      "type": "Specialty",
      "code": "ADU",
      "values": {
        "en": "Adult Health (APNs)"
      },
      "customerOwned": false,
      "inactive": false,
      "countries": [
        "US"
      ]
    },
    {
      "type": "Specialty",
      "code": "OAR",
      "values": {
        "en": "Adult Reconstructive Orthopedics"
      },
      "customerOwned": false,
      "inactive": false,
      "countries": [
        "US"
      ]
    }
  ]
}

Retrieve reference data type code details metadata

This API enables you to retrieve detailed information about reference data type codes in Network.

Endpoint URL

https://{DNS}/api/{version}/metadata/reference_values/{type}/{codes}

DNS is the URL for your API service
version is the API version
type is the specific data type to retrieve details about
codes is a comma-separated list of codes to look up for the specified type. Unknown codes for the given type are ignored, without errors.

Optional parameters
country: Filter codes by country, only if includeCodes is True:
Default - do not filter by country
Values - The desired country value, for example, US, GB, FR. The country must be visible to the authenticated user.
countries: Filter fields by country visibility:
Default - do not filter by country
Values - The desired country values, for example, US, GB, FR. The countries must be visible to the authenticated user.
systemName: Return target alias values specified for reference value codes for this system:
Default - return the default reference value codes

Response
responseStatus: The status of the response from Network.
reference_type_codes: An array of reference code objects:
type - the reference type value of the code, for example, Country
code - the reference code value
values - an array of language/value pairs. Each reference item has its textual value provided in a set of translations. This array can be used to determine which languages are supported and the value for each language. For example: [{"en":"Canada"},{"zh":"加拿大"},{"fr":"Canada"},{"de":"Kanada"}]. Language codes are IETF language tags.
customerOwned - True if this is a customer created reference code, False otherwise.
inactive - True if this reference type has been inactivated
countries - list of countries for which the code is visible, for example, US or GB.

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/metadata/reference_values/Specialty/A?country=US'

{
   "responseStatus" : "SUCCESS",
   "reference_type_codes" : [
      {
         "type" : "Specialty",
         "values" : {
            "tr" : "Alerji",
            "el" : "Αλλεργιολογία",
            "zh_HK" : "過敏",
            "pt" : "Imunoalergología",
            "da" : "Allergi",
            "es" : "Alergología",
            "sk" : "Alergológia",
            "en-GB" : "Allergology",
            "pl" : "Alergologia",
            "hu" : "Allergológia",
            "it" : "Allergologia",
            "en" : "Allergy",
            "ja" : "アレルギー科",
            "zh" : "过敏症",
            "fi" : "Allergia",
            "pt-BR" : "Alergologia",
            "cs" : "Alergologie",
            "fr" : "Maladies allergiques",
            "de" : "Allergie",
            "ru" : "Аллергология",
            "nl" : "Allergologie",
            "no" : "Allergi",
            "sv" : "Allergologi",
            "bg" : "Клинична алергология"
         },
         "countries" : [
            "US"
         ],
         "inactive" : false,
         "code" : "A",
         "customerOwned" : false
      }
   ]
}

Match

The match API enables you to match data immediately for a single record, which is helpful when you need to verify data in real-time; for example, when registering HCPs in a portal. You can match the data using an API call instead of trying to verify the data using Network Search which requires multiple searches, filtering and field queries.

The API uses the default match rules for your Network instance.

Retrieve Matches

This API enables you to match data immediately for a single record using match rules from the specified Network instance.

Endpoint URL

https://DNS/api/version/match

DNS - is the URL for your API service
version - is the API version

Optional Parameters
addressCleansing: Cleanse the input address before matching. The default is False.
includeMasterResults: Include results from Veeva OpenData with results from customer data. The default uses the configuration of Veeva OpenData search.
limit: Integer type. The number of results to return. The default is 10. The maximum is 50.
matchRuleCollection: The name of the match rule collection to be used for matching. By default, the country default match rules are used.
systemName: When provided, Network returns target alias values defined for reference codes for this system. Otherwise, Network returns default reference code values.
enrichedResults: Specifies whether or not to display labels for reference type fields in the results.
resultLanguage: Specifies the language to use if the enriched results option is enabled. Uses the IETF BCP 47 language standard.

POST Data
entity_type: The entity type for the match request.
entities: The entity data, using the structure and fields from the data model of the specified Network instance. The primary_country__v field and associated value are required.

Response
responseStatus: The status of the response.
matchSetup: Details about the match configuration that was used.
sourceEntity: The data used in the match request.
matchEntities: An array of attribute information for the objects; for example, the Network entity ID, ASK or ACT match, or feature set. Each entity includes match results that provide details such as the match advice, confidence level, rank group, and rank score.
totalCount: The number of matched entities.
limit: The maximum number of results returned in this request.

Notes

responseStatus returns a failure if any standard errors occur or if:

The request was submitted without an entity type.
The entity type provided is invalid.
The request was submitted without a primary country.
The primary country code provided is invalid.

responseStatus returns INSUFFICIENT_ACCESS if:

A data steward, portal user, or standard user submits the request.

The following users can submit a request using the match API if they have API access enabled:

System and Data Admin
System Administrator
Data Manager
Integration User

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" https://my.veevanetwork.com/api/v33.0/match

{
  "entity_type": "HCP",
  "entity": {
    "first_name__v" : "Clinton",
    "last_name__v" : "Ackerman",
    "addresses__v": [
      {
        "address_line_1__v" : "1240 India Street",
        "locality__v": "San Diego",
        "administrative_area__v": "US-CA",
        "country__v": "US"
      }
    ],
    "licenses__v": [
     {
      "license_number__v" : "0123456A"
     }
    ],
  "primary_country__v": "US"
  }
}

{
  "status": "SUCCESS",
  "message": null,
  "requestTS": 1629735205762,
  "payload": {
    "matchSetup": {
      "country": "US",
      "entityType": "HCP",
      "includeMasterResults": true,
      "addressCleansing": true
    },
    "sourceEntity": {
      "first_name__v": "Amanda",
      "last_name__v": "Jackson",
      "npi_num__v": "1669926804",
      "primary_country__v": "US",
      "sha_id__v": "722739",
      "vid__v": "6656453490",
      "me_id__v": "0350313065",
      "addresses__v": [
        {
          "address_line_1__v": "8333 Goodwood Blvd",
          "locality__v": "Milwaukee",
          "postal_code__v": "53226",
          "country__v": "US",
          "phone_1__v": "8474281179",
          "administrative_area__v": "US-WI"
        }
      ],
      "licenses__v": [
        {
          "type_value__v": "IL",
          "license_number__v": "67198",
          "vid__v": "66564534634"
        },
        {
          "type_value__v": "DEA",
          "license_number__v": "BM2637126",
          "vid__v": "66564534"
        }
      ],
      "parent_hcos__v": [
        {
          "parent_hco_corp_name__m": "Thida Maw MD Pediatrics"
        },
        {
          "parent_hco_vid__v": "932179080181712799"
        }
      ]
    },
    "matchedEntities": [
      {
        "metaData": {
          "vid__v": "938361996114591775",
          "resultFromMaster": false,
          "fromMasterInstance": -1,
          "dataGroups": {
            "addresses__v.locality__v=milwaukee & is_externally_mastered__v!=true & primary_country__v=us": 1,
            "is_externally_mastered__v!=true & primary_country__v=us & sha_id__v=722739": 1,
            "first_name__v=amanda & is_externally_mastered__v!=true & last_name__v=jackson & primary_country__v=us": 1,
            "is_externally_mastered__v!=true & npi_num__v=1669926804 & primary_country__v=us": 1,
            "addresses__v.locality__v=milwaukee & first_name__v=amanda & is_externally_mastered__v!=true & primary_country__v=us": 1,
            "addresses__v.locality__v=milwaukee & is_externally_mastered__v!=true & last_name__v=jackson & primary_country__v=us": 1
          },
          "downloadFromMaster": false
        },
        "matchResult": {
          "advice": "ACT",
          "rankScore": 1.0,
          "rankGroup": "first_name",
          "confidence": 0.985,
          "featureInfoList": [
            {
              "name": "NPI is not different",
              "fields": [
                "npi_num__v"
              ]
            },
            {
              "name": "SHA ID is identical",
              "fields": [
                "sha_id__v"
              ]
            }
          ]
        },
        "entityType": "HCP",
        "entityId": "938361996114591775",
        "entity": {
          "npi_num__v": "1669926804",
          "sha_id__v": "722739"
        }
      },
      {
        "metaData": {
          "vid__v": "938361996114591775",
          "resultFromMaster": true,
          "fromMasterInstance": 2,
          "dataGroups": {
            "addresses__v.locality__v=milwaukee & is_externally_mastered__v!=true & primary_country__v=us": 0,
            "is_externally_mastered__v!=true & primary_country__v=us & sha_id__v=722739": 1,
            "first_name__v=amanda & is_externally_mastered__v!=true & last_name__v=jackson & primary_country__v=us": 1,
            "is_externally_mastered__v!=true & npi_num__v=1669926804 & primary_country__v=us": 1,
            "addresses__v.locality__v=milwaukee & first_name__v=amanda & is_externally_mastered__v!=true & primary_country__v=us": 0,
            "addresses__v.locality__v=milwaukee & is_externally_mastered__v!=true & last_name__v=jackson & primary_country__v=us": 0
          },
          "downloadFromMaster": true
        },
        "matchResult": {
          "advice": "ACT",
          "rankScore": 0.5,
          "rankGroup": "groupB_hcp_type",
          "confidence": 0.985,
          "featureInfoList": [
            {
              "name": "NPI is not different",
              "fields": [
                "npi_num__v"
              ]
            },
            {
              "name": "SHA ID is identical",
              "fields": [
                "sha_id__v"
              ]
            }
          ]
        },
        "entityType": "HCP",
        "entityId": "938361996114591775",
        "entity": {
          "npi_num__v": "1669926804",
          "sha_id__v": "722739"
        }
      }
    ],
    "totalCount": 2,
    "limit": 10
  },
  "sr": "SR"
}

Merge

The merge event APIs enable you to retrieve details about merge and unmerge events for a specified date. This enables downstream systems to receive and process merges and unmerges very quickly after they occur.

Merge event calls are limited to 100 results. You can include the offset parameter in subsequent requests to retrieve additional pages of results.

Retrieve Merges

This API enables you to retrieve the results of merge events that occurred in your Network instance.

Merges initiated by Veeva OpenData on a master instance are included if the surviving and losing records of the merge have been downloaded to your instance.

Endpoint URL

https://DNS/api/version/event/merge

DNS - is the URL for your API service
version - is the API version

Optional Parameters
systemName: When provided, Network returns target alias values defined for reference codes for this system. Otherwise, Network returns default reference code values.
enrichedResults: Specifies whether or not to display labels for reference type fields in the results.
resultLanguage: Specifies the language to use if the enriched results option is enabled. Uses the IETF BCP 47 language standard.

Response
responseStatus: The status of the response.
totalCount: The number of results matching the request. When the total count exceeds the limit (100), you can run subsequent requests using the offset parameter to get additional page results.
offset: The offset of this request.
sinceDate: The requested start date in ISO 8601 format.
events: A list of the event details.

type - The type of event; for example, MERGE.

date - The date of the event in ISO 8601 format.

entities - A list of the event details.

type - The type of event or action; for example MERGE_SURVIVOR or MERGE_NONSURVIVOR.

entityID - The Network ID (vid__v) of the entity.

entityType - The type of entity; for example HCO or HCP.

curl -X GET -H "Authorization: 5A4A96438B07E1A8AF2D50CCB331EDB53A9BD4B201AD6EF7FF3260A4463CD8D4D046D7C3C6193CB837BFE818623A473A436CC6034096376DBBB762D9C6378DB47D4C4B2969026999538A1009E3EBBBE0" https://my.veevanetwork.com/api/v33.0/event/merge?sinceDate=2017-01-01T00:00:00.000-00:00

{
  "responseStatus":"SUCCESS",
  "totalCount":2,
  "offset":0,
  "limit":100,
  "sinceDate":"2017-01-01T00:00:00.000Z",
  "events":[{
      "type":"MERGE",
      "date":"2018-04-24T03:38:34.000Z",
      "entities":[{
          "type":"MERGE_SURVIVOR",
          "entityId":"931521762955172639",
          "entityType":"HCP"
        },
        {
          "type":"MERGE_NONSURVIVOR",
          "entityId":"931521742609390367",
          "entityType":"HCP"
        }
      ]
    },
    {
      "type":"MERGE",
      "date":"2018-04-24T03:38:34.000Z",
      "entities":[{
          "type":"MERGE_SURVIVOR",
          "entityId":"931539432462359327",
          "entityType":"HCP"
        },
        {
          "type":"MERGE_NONSURVIVOR",
          "entityId":"931539429690448671",
          "entityType":"HCP"
        }
      ]
    }
  ]
}

Retrieve Unmerges

This API enables you to retrieve the results of unmerge events that occurred in your Network instance.

Unmerges include events that occurred in your Network instance; only customer (gray) records are reported.

Endpoint URL

https://DNS/api/version/event/unmerge

DNS - is the URL for your API service
version - is the API version

Optional Parameters
systemName: When provided, Network returns target alias values defined for reference codes for this system. Otherwise, Network returns default reference code values.
enrichedResults: Specifies whether or not to display labels for reference type fields in the results.
resultLanguage: Specifies the language to use if the enriched results option is enabled. Uses the IETF BCP 47 language standard.

Response
responseStatus: The status of the response.
totalCount: The number of results matching the request. When the total count exceeds the limit (100), you can run subsequent requests using the offset parameter to get additional page results.
offset: The offset of this request.
sinceDate: The requested start date in ISO 8601 format.
events: A list of the event details.

type - The type of event; for example, MERGE.

date - The date of the event in ISO 8601 format.

entities - A list of the event details.

type - The type of event or action; for example MERGE_SURVIVOR or MERGE_NONSURVIVOR.

entityID - The Network ID (vid__v) of the entity.

entityType - The type of entity; for example HCO or HCP.

curl -X GET -H "Authorization: 5A4A96438B07E1A8AF2D50CCB331EDB53A9BD4B201AD6EF7FF3260A4463CD8D4D046D7C3C6193CB837BFE818623A473A436CC6034096376DBBB762D9C6378DB47D4C4B2969026999538A1009E3EBBBE0" https://my.veevanetwork.com/api/v33.0/event/merge?sinceDate=2017-01-01T00:00:00.000-00:00

{
  "responseStatus":"SUCCESS",
  "totalCount":2,
  "offset":0,
  "limit":100,
  "sinceDate":"2017-01-01T00:00:00.000Z",
  "events":[{
      "type":"UNMERGE",
      "date":"2018-04-24T03:38:34.000Z",
      "entities":[{
          "type":"UNMERGE_ORIGINAL",
          "entityId":"931498177374133023",
          "entityType":"HCP"
        },
        {
          "type":"UNMERGE_NEW",
          "entityId":"931498286389467937",
          "entityType":"HCP"
        }
      ]
    },
    {
      "type":"UNMERGE",
      "date":"2018-04-24T03:38:34.000Z",
      "entities":[{
          "type":"UNMERGE_ORIGINAL",
          "entityId":"931521762955172639",
          "entityType":"HCP"
        },
        {
          "type":"UNMERGE_NEW",
          "entityId":"931538200903031583",
          "entityType":"HCP"
        }
      ]
    }
  ]
}

Search

Search calls enable you to construct simple, yet powerful searches to retrieve data from Network.

Calls through the Search API pass a query string in an expression that specifies the search text and specific parameters to get the intended set of entities from Network. Search results are ranked according to closeness to the search terms specified.

Search

This API enables you to retrieve the full set of entities and child objects matching the specified search criteria.

Endpoint URL

https://DNS/api/version/search

DNS - is the URL for your API service
version - is the API version

Parameters

The query string (type text).

address_q

The query string scoped to the address object of the entity.

types

The entity type; ALL for all objects, HCO or HCP or a specific object value for custom objects (for example, STUDY__C). If not specified, the default is all types, and only Veeva objects are searched; custom objects will not be searched.

offset

The pagination number (type integer). The default is 0.

limit

The number to limit the results returned (type integer). The default is 10. The maximum is 100.

sort

The attribute to sort results by (type text). For example, first_name__v.

sortOrder

The sort order for the search. Value is asc for ascending or desc for descending.

states

A list of entity states to match on, including VALID, DELETED, UNDER_REVIEW, MERGED_INTO, MERGE_INACTIVATED, MERGE_ADDED, or INVALID.

statuses

A list of entity statuses to match on, including A (active), C (closed), D (deceased), I (inactive), R (retired), U (unknown), X (unknown license).

returnFacets

Include the facets in the response. The default is False.

returnHighlights

Include highlights in the response. The default is True.

facetCount

The maximum number of items to return for each facet (type integer). The default is 500.

includeMasterResults

Include results from Veeva OpenData with results of the customer data. The default uses the configuration of Veeva OpenData search.

searchOnlyMaster

Include results only from Veeva OpenData. The default is False. Veeva OpenData search must be enabled by configuration.

filters

The filters for refining the result, for example, Country, Region, or Specialty (type text). For child entity attributes, use the following aliases:

Filters support scoped entity filters, which enable users to apply filters to a specific entity:

Filters also support collection fields, which enable users to search an OR condition across a collection of fields during search. The fields must be enabled in the data model to be included in collection.

Search filters should not be used with multivalued fields.

fieldQueries

The filters for refining the result (PARTIAL MATCH). For child entity attributes, use the following aliases:

lang

The language to run the query against. This is important when searching on reference values. For example, a search on "John Smith Pediatrics" will not return results for the specialty of pediatrics if the specified language is Chinese. If a language is not provided in the search query, the authenticated API user's default language is used.

systemName

If provided, Network returns target alias values specified for reference value codes for this system. If not provided, Network returns default reference value codes.

supplemental

If provided, Network returns related parent HCOs of the entities found in the supplemental results.

filterByLocation

Search results are filtered by their proximity to the specified location. Results outside the specified distance are excluded. The parameter is a comma separated list of fields in the format of "latitude, longitude, distance, bottomRightLatitude, bottomRightLongitude, filterType":

sortByLocation

Search results are sorted by their proximity to the specified location. The parameter is a geo coordinate pair in the form latitude,longitude (for example 38.889931,-77.009003). Sort by location cannot be combined with sort by other attributes.

sortResultChildren

For search results containing addresses, licenses or parent HCOs, they will be sorted starting with the most relevant result. Default is False.

The returnHighlights flag must also be True for this functionality.

Address sort rules:

License sort rules:

Parent HCO sort rules:

nestChildObjectFieldQueries

Specifies whether or not to apply nesting to child object clauses. This will convert a requested field query into a fuzzy matching filter on the same field. The default is False.

parenthcofilters

Specifies the filters for parent HCO results. Parent HCOs in the parent_hco__v and supplementalResults sections will be returned if they pass these filters. The format is identical to filters but does not support filtering by child entities of the HCO.

enrichedResults

Specifies whether or not to display labels for reference type fields in the results.

resultLanguage

Specifies the language to use if the enriched results option is enabled. Uses the IETF BCP 47 language standard.

excludefilters

The filters for excluding results. The format is identical to filters but does not support child entity-scoped attributes.

parenthcoexcludefilters

The filters for excluding parent HCO results. Parent HCOs in the parent_hco__v and supplementalResults sections will not be returned if they pass these filters. The format is identical to filters but does not support filtering by child entities of the HCO.

returnHashtagsForType

Return hashtags for the requested type using the following values:

Response
responseStatus: The status of the response from Network.
entitiess: An array of attribute information objects:
entityId - The ID of the entity.
entityType - The entity type, either HCP or HCO.
metaData - An array of attribute information objects:
highlightTerms - the extracted terms from the highlights.
resultIsFromMaster - specifies whether the record is from Veeva OpenData when search against master is enabled. If enabled in the Network instance, results from Veeva OpenData will include custom fields with default values or with calculated values (using Network expressions).
vid__v - the Veeva entity ID.
relevance - the relevance score for the entity relative to other results.
highlights - the exact results from the elastic search.
entity - An array of attribute information objects containing all populated fields for the entities returned. An address child object may include the following fields:
geo_distance__u - A distance field. When sortByLocation is submitted, the addresses in the results return the distance in kilometers from the specified location.
totalCount: The total number of records hitting the search, regardless of limit.
offset: The pagination number. The default is 0.
limit: The number provided to limit the results.
supplementalResults: An array of attribute information objects containing details of the parent HCOs returned on the results.
hashtags: The list of hashtags available to the authenticated API user:
name - the hashtag name.
color - the hashtag color.
tooltip - the tooltip of the hashtag.
tooltipLabel - the field value label of the hashtag.
tooltipValue - the field value of the hashtag.
tooltipHasOtherValue - Returns True if the tooltip has more than three field values.

Notes

There are two lines for highlights: The first contains the terms and the second contains the output from the search engine.
The supplmentalResults set at the end of the result contains the external entity information of any parent HCOs referenced in the main results. Use the parent_hco_vid_v from the parent_hcos__v set and the vid_v on the supplmentalResults for reference.
Network-specific fields are returned by the API regardless of region.
Filters are not supported for Date or DateTime type fields.
Search only returns results based on visibility rules defined in the data visibility profile of the API user.

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/search?q=*&filters=birth_year__v:1901&statuses=R'

{
   "limit" : 10,
   "offset" : 0,
   "totalCount" : 1,
   "responseStatus" : "SUCCESS",
   "entities" : [
      {
         "entityType" : "HCP",
         "entity" : {
            "middle_name__v" : "Fabian",
            "pdrp_optout__v" : "N",
            "licenses__v" : [
               {
                  "is_veeva_master__v" : true,
                  "initial_board_license_date__v" : "2014-06-13",
                  "license_degree__v" : "MD",
                  "record_owner_name__v" : "OpenData",
                  "record_delta_id__v" : "933098577956798466",
                  "license_number__v" : "MD.004455",
                  "dea_business_activity_code__v" : "ZZ",
                  "license_subtype__v" : "U",
                  "license_eligibility__v" : "I",
                  "is_externally_mastered__v" : false,
                  "vid__v" : "243370156514870327",
                  "custom_keys__v" : [
                     {
                        "custom_key_vid_key__v" : "MASTER__v:LICENSE:243370156514870327",
                        "custom_key_status__v" : "A",
                        "custom_key_entity_id__v" : "243370156514870327",
                        "modified_date__v" : "2018-09-12T23:33:43.000Z",
                        "custom_key_source_type__v" : "MASTER__v",
                        "created_date__v" : "2018-09-12T23:33:43.000Z",
                        "vid__v" : "933098577621944938",
                        "custom_key_entity_type__v" : "LICENSE",
                        "custom_key_value__v" : "243370156514870327",
                        "status_update_time__v" : "2018-09-12T23:33:43.000Z",
                        "custom_key_item_type__v" : "LICENSE"
                     }
                  ],
                  "entity_type__v" : "HCP",
                  "type_value__v" : "LA",
                  "type__v" : "STATE",
                  "grace_period__v" : "1959-12-31",
                  "record_owner_type__v" : "VOD",
                  "body__v" : "BOME",
                  "license_status_condition__v" : "0",
                  "status_update_time__v" : "2018-09-12T23:33:43.000Z",
                  "rxa_eligible__v" : "I",
                  "record_state__v" : "VALID",
                  "expiration_date__v" : "1959-12-31",
                  "primary_license__c" : "U",
                  "created_date__v" : "2018-09-12T23:33:43.000Z",
                  "best_state_license__v" : "Y",
                  "modified_date__v" : "2018-09-12T23:33:43.000Z",
                  "license_status__v" : "I",
                  "entity_vid__v" : "243201884351890434"
               },
               {
                  "body__v" : "BOME",
                  "license_status_condition__v" : "0",
                  "grace_period__v" : "1989-10-31",
                  "record_owner_type__v" : "VOD",
                  "status_update_time__v" : "2018-09-12T23:33:43.000Z",
                  "rxa_eligible__v" : "I",
                  "record_state__v" : "VALID",
                  "created_date__v" : "2018-09-12T23:33:43.000Z",
                  "primary_license__c" : "U",
                  "expiration_date__v" : "1989-10-31",
                  "modified_date__v" : "2018-09-12T23:33:43.000Z",
                  "best_state_license__v" : "Y",
                  "entity_vid__v" : "243201884351890434",
                  "license_status__v" : "I",
                  "license_degree__v" : "MD",
                  "record_owner_name__v" : "OpenData",
                  "is_veeva_master__v" : true,
                  "initial_board_license_date__v" : "2011-06-15",
                  "dea_business_activity_code__v" : "ZZ",
                  "license_subtype__v" : "U",
                  "license_eligibility__v" : "I",
                  "license_number__v" : "C00007347",
                  "record_delta_id__v" : "933098577956798467",
                  "vid__v" : "243370156514870329",
                  "is_externally_mastered__v" : false,
                  "custom_keys__v" : [
                     {
                        "custom_key_value__v" : "243370156514870329",
                        "status_update_time__v" : "2018-09-12T23:33:43.000Z",
                        "custom_key_item_type__v" : "LICENSE",
                        "custom_key_entity_type__v" : "LICENSE",
                        "custom_key_source_type__v" : "MASTER__v",
                        "created_date__v" : "2018-09-12T23:33:43.000Z",
                        "vid__v" : "933098577622010463",
                        "custom_key_status__v" : "A",
                        "custom_key_vid_key__v" : "MASTER__v:LICENSE:243370156514870329",
                        "custom_key_entity_id__v" : "243370156514870329",
                        "modified_date__v" : "2018-09-12T23:33:43.000Z"
                     }
                  ],
                  "type_value__v" : "CA",
                  "type__v" : "STATE",
                  "entity_type__v" : "HCP"
               }
            ],
            "me_id__v" : "0210540047",
            "record_owner_name__v" : "OpenData",
            "birth_country__v" : "US",
            "record_delta_id__v" : "933099059764428799",
            "hcp_status__v" : "R",
            "vid__v" : "243201884351890434",
            "type_of_practice__v" : "98",
            "is_externally_mastered__v" : false,
            "master_vid__v" : "243201884351890434",
            "custom_keys__v" : [
               {
                  "custom_key_entity_type__v" : "HCP",
                  "custom_key_item_type__v" : "HCP",
                  "status_update_time__v" : "2018-09-12T23:33:43.000Z",
                  "custom_key_value__v" : "243201884351890434",
                  "custom_key_entity_id__v" : "243201884351890434",
                  "modified_date__v" : "2018-09-12T23:33:43.000Z",
                  "custom_key_status__v" : "A",
                  "custom_key_vid_key__v" : "MASTER__v:HCP:243201884351890434",
                  "created_date__v" : "2018-09-12T23:33:43.000Z",
                  "vid__v" : "933098577622010465",
                  "custom_key_source_type__v" : "MASTER__v"
               }
            ],
            "last_name__v" : "Herman",
            "ama_do_not_contact__v" : "N",
            "gender__v" : "M",
            "prefix__v" : "DR",
            "record_owner_type__v" : "VOD",
            "kaiser__v" : "N",
            "record_state__v" : "VALID",
            "years_in_progress__v" : 0,
            "grad_trg_end_date__v" : "1947-10-31",
            "NewAlt__c" : "KW6NW2RQJZC",
            "specialty_1_rank__v" : 1,
            "primary_country__v" : "US",
            "birth_city__v" : "SEATTLE",
            "modified_date__v" : "2018-09-12T23:33:43.000Z",
            "place_of_employment__v" : "99",
            "birth_state__v" : "US-WA",
            "hcp_type__v" : "P",
            "specialty_1__v" : "U",
            "is_veeva_master__v" : true,
            "record_version__v" : 0,
            "mpa__v" : "90",
            "parent_hcos__v" : [],
            "formatted_name__v" : "Winfield Herman ",
            "ams_id__v" : "854071",
            "status_update_time__v" : "2018-09-12T23:33:38.000Z",
            "addresses__v" : [
               {
                  "address_status__v" : "I",
                  "record_delta_id__v" : "933098577956798465",
                  "dpv_confirmed_indicator__v" : "X",
                  "record_owner_name__v" : "OpenData",
                  "entity_type__v" : "HCP",
                  "formatted_address__v" : "1808 Verdugo Blvd Ste 110 Glendale CA 91208-1450",
                  "delivery_address_1__v" : "1808 Verdugo Blvd Ste 110",
                  "cbsa__v" : "31100",
                  "thoroughfare_name__v" : "Verdugo",
                  "address_type__v" : "P",
                  "thoroughfare_trailing_type__v" : "Blvd",
                  "is_externally_mastered__v" : false,
                  "locality__v" : "Glendale",
                  "vid__v" : "243370156514870324",
                  "custom_keys__v" : [
                     {
                        "custom_key_source_type__v" : "MASTER__v",
                        "created_date__v" : "2018-09-12T23:33:43.000Z",
                        "vid__v" : "933098577621944936",
                        "custom_key_vid_key__v" : "MASTER__v:ADDRESS:243370156514870324",
                        "custom_key_status__v" : "A",
                        "custom_key_entity_id__v" : "243370156514870324",
                        "modified_date__v" : "2018-09-12T23:33:43.000Z",
                        "status_update_time__v" : "2018-09-12T23:33:43.000Z",
                        "custom_key_value__v" : "243370156514870324",
                        "custom_key_item_type__v" : "ADDRESS",
                        "custom_key_entity_type__v" : "ADDRESS"
                     }
                  ],
                  "postal_code__v" : "91208-1450",
                  "ISO_3166_n__v" : "840",
                  "postal_code_secondary__v" : "1450",
                  "thoroughfare__v" : "Verdugo Blvd",
                  "record_state__v" : "VALID",
                  "record_owner_type__v" : "VOD",
                  "sub_administrative_area__v" : "Los Angeles",
                  "modified_date__v" : "2018-09-12T23:33:43.000Z",
                  "entity_vid__v" : "243201884351890434",
                  "address_line_1__v" : "1808 Verdugo Blvd Ste 110",
                  "administrative_area__v" : "US-CA",
                  "country__v" : "US",
                  "premise__v" : "1808",
                  "premise_number__v" : "1808",
                  "delivery_address__v" : "1808 Verdugo Blvd Ste 110",
                  "ISO_3166_3__v" : "USA",
                  "is_veeva_master__v" : true,
                  "sub_building_number__v" : "110",
                  "sub_building__v" : "Ste 110",
                  "postal_code_primary__v" : "91208",
                  "sub_building_type__v" : "Ste",
                  "address_ordinal__v" : 99,
                  "status_update_time__v" : "2018-09-12T23:33:43.000Z",
                  "latitude__v" : 34.205607,
                  "address_verification_status__v" : "V",
                  "created_date__v" : "2018-09-12T23:33:43.000Z",
                  "longitude__v" : -118.215157
               },
               {
                  "entity_vid__v" : "243201884351890434",
                  "modified_date__v" : "2018-09-12T23:33:43.000Z",
                  "administrative_area__v" : "US-CA",
                  "premise__v" : "2640",
                  "country__v" : "US",
                  "address_line_1__v" : "2640 Honolulu Ave 22w",
                  "thoroughfare__v" : "Honolulu Ave",
                  "record_state__v" : "VALID",
                  "postal_code__v" : "91020-1707",
                  "postal_code_secondary__v" : "1707",
                  "ISO_3166_n__v" : "840",
                  "sub_administrative_area__v" : "Los Angeles",
                  "record_owner_type__v" : "VOD",
                  "cbsa__v" : "31100",
                  "thoroughfare_name__v" : "Honolulu",
                  "thoroughfare_trailing_type__v" : "Ave",
                  "address_type__v" : "P",
                  "entity_type__v" : "HCP",
                  "formatted_address__v" : "2640 Honolulu Ave 22w Montrose CA 91020-1707",
                  "delivery_address_1__v" : "2640 Honolulu Ave 22w",
                  "custom_keys__v" : [
                     {
                        "status_update_time__v" : "2018-09-12T23:33:43.000Z",
                        "custom_key_value__v" : "243370156514870322",
                        "custom_key_item_type__v" : "ADDRESS",
                        "custom_key_entity_type__v" : "ADDRESS",
                        "custom_key_source_type__v" : "MASTER__v",
                        "vid__v" : "933098577621944932",
                        "created_date__v" : "2018-09-12T23:33:43.000Z",
                        "custom_key_vid_key__v" : "MASTER__v:ADDRESS:243370156514870322",
                        "custom_key_status__v" : "A",
                        "modified_date__v" : "2018-09-12T23:33:43.000Z",
                        "custom_key_entity_id__v" : "243370156514870322"
                     }
                  ],
                  "is_externally_mastered__v" : false,
                  "vid__v" : "243370156514870322",
                  "locality__v" : "Montrose",
                  "record_delta_id__v" : "933098577956798464",
                  "address_status__v" : "I",
                  "dpv_confirmed_indicator__v" : "S",
                  "record_owner_name__v" : "OpenData",
                  "latitude__v" : 34.20894,
                  "address_verification_status__v" : "V",
                  "created_date__v" : "2018-09-12T23:33:43.000Z",
                  "longitude__v" : -118.23679,
                  "postal_code_primary__v" : "91020",
                  "status_update_time__v" : "2018-09-12T23:33:43.000Z",
                  "address_ordinal__v" : 99,
                  "sub_building__v" : "22w",
                  "sub_building_number__v" : "22w",
                  "premise_number__v" : "2640",
                  "delivery_address__v" : "2640 Honolulu Ave 22w",
                  "is_veeva_master__v" : true,
                  "ISO_3166_3__v" : "USA"
               }
            ],
            "entity_is_third_party_master_for_search_only__v" : false,
            "fellow__v" : "N",
            "birth_year__v" : 1901,
            "created_date__v" : "2018-09-12T23:33:43.000Z",
            "grad_training__v" : "N",
            "education_level__v" : "RESIDENCY",
            "first_name__v" : "Winfield",
            "medical_degree_1__v" : "MD",
            "upin__v" : "A54406"
         },
         "entityId" : "243201884351890434",
         "metaData" : {
            "highlights" : null,
            "highlightTerms" : null,
            "vid__v" : "243201884351890434",
            "relevance" : 13
         }
      }
   ]
}

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/search?q=*&limit=20&nestChildObjectFieldQueries=true&types=HCP&offset=0&filters=primary_country__v:US&fieldQueries=hcp.first_name__v:Mary~hcp.last_name__v:Smith'

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/search?q=*&nestChildObjectFieldQueries=true&q=*&types=HCP&filters=primary_country__v:US~address.administrative_area__v:US-IL&fieldQueries=hcp.first_name__v:Mary~hcp.last_name__v:Smith~address.locality__v:Chicago'

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/search?q=*&nestChildObjectFieldQueries=true&q=*&types=HCP&filters=address.country__v:US~hcp.npi_num__v:1244717607'

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/search?q=*&excludefilters=specialty_1__v:CPP,PMG,PPM,PDM,EMP,PD,PDN,CHC

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/search?q=*&filterByLocation=40.7,-74,1km'

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/search?q=*&sortByLocation=40.7,-74&filterByLocation=40.7,-74,5km,,,DISTANCE'

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/search?q=*&sortByLocation=40.7,-74&filterByLocation=40.7,-74,5km,,,BOUNDING_BOX'

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/search?q=*&filterByLocation=41.7,-75,,40.5,-74,BOUNDING_BOX'

{
    "responseStatus": "SUCCESS",
    "entities": [
        {
            "entityId": "242980123077248009",
            "entityType": "HCP",
            "metaData": {
                "highlights": {
                    "hcp_first_name__v": [
                        "<em>Daniel</em>"
                    ],
                    "hcp_formatted_name__v": [
                        "<em>Daniel</em> Witcher"
                    ],
                    "parent_hco_corp_name__v": [
                        "Navy Medical Center <em>San Diego</em>",
                        "Navy Medical Center <em>San Diego</em>"
                    ]
                },
                "vid__v": "242980123077248009",
                "canDownloadFromMaster": true,
                "highlightTerms": [
                    "San Diego",
                    "Daniel"
                ],
                "resultIsFromMaster": true,
                "fromMasterInstance": 2,
                "relevance": 84.370964
            },
            "entity": {
                "gender__v": "U",
                "specialty_1__v": "US",
                "hcp_type__v": "P",
                "master_vid__v": "242980123077248009",
                "first_name__v": "Daniel",
                "grad_training__v": "N",
                "record_delta_id__v": "931585269642919935",
                "last_name__v": "Witcher",
                "medical_degree_1__v": "DDS",
                "fellow__v": "N",
                "middle_name__v": "S",
                "kaiser__v": "N",
                "formatted_name__v": "Daniel Witcher",
                "primary_country__v": "US",
                "created_date__v": "2017-12-20T00:18:20.000Z",
                "pdrp_optout__v": "N",
                "is_veeva_master__v": true,
                "hcp_status__v": "A",
                "ama_do_not_contact__v": "N",
                "status_update_time__v": "2017-12-20T00:18:19.000Z",
                "ams_id__v": "15864629",
                "modified_date__v": "2017-12-20T00:18:20.000Z",
                "record_state__v": "VALID",
                "record_version__v": 0,
                "vid__v": "242980123077248009",
                "entity_is_third_party_master_for_search_only__v": false,
                "is_externally_mastered__v": false,
                "specialty_1_rank__v": 1,
                "licenses__v": [
                    {
                        "address_vid__v": "420505979138970626",
                        "license_number__v": "FW4591790",
                        "best_state_license__v": "N",
                        "license_eligibility__v": "U",
                        "status_update_time__v": "2017-12-20T00:18:20.000Z",
                        "record_delta_id__v": "931585265015816200",
                        "drug_schedule__v": "22N 33N 4 5",
                        "license_status__v": "X",
                        "entity_type__v": "HCP",
                        "expiration_date__v": "2017-05-31",
                        "modified_date__v": "2017-12-20T00:18:20.000Z",
                        "rxa_eligible__v": "U",
                        "record_state__v": "VALID",
                        "dea_business_activity_code__v": "C0",
                        "vid__v": "420505979180913670",
                        "entity_vid__v": "242980123077248009",
                        "created_date__v": "2017-12-20T00:18:20.000Z",
                        "type__v": "ADDRESS",
                        "is_veeva_master__v": true,
                        "type_value__v": "DEA"
                    },
                    {
                        "address_vid__v": "412146222338511876",
                        "license_number__v": "FW4197857",
                        "best_state_license__v": "N",
                        "license_eligibility__v": "U",
                        "status_update_time__v": "2017-12-20T00:18:20.000Z",
                        "record_delta_id__v": "931585265015816199",
                        "drug_schedule__v": "22N 33N 4 5",
                        "license_status__v": "I",
                        "entity_type__v": "HCP",
                        "expiration_date__v": "2016-05-31",
                        "modified_date__v": "2017-12-20T00:18:20.000Z",
                        "rxa_eligible__v": "U",
                        "record_state__v": "VALID",
                        "dea_business_activity_code__v": "C0",
                        "vid__v": "243244052365968391",
                        "entity_vid__v": "242980123077248009",
                        "created_date__v": "2017-12-20T00:18:20.000Z",
                        "type__v": "ADDRESS",
                        "is_veeva_master__v": true,
                        "type_value__v": "DEA"
                    }
                ],
                "addresses__v": [
                    {
                        "dpv_confirmed_indicator__v": "X",
                        "postal_code_primary__v": "92134",
                        "address_line_1__v": "34800 Bob Wilson Dr",
                        "premise__v": "34800",
                        "cbsa__v": "41740",
                        "record_delta_id__v": "931585265015816198",
                        "locality__v": "San Diego",
                        "delivery_address__v": "34800 Bob Wilson Dr",
                        "country__v": "US",
                        "created_date__v": "2017-12-20T00:18:20.000Z",
                        "premise_number__v": "34800",
                        "is_veeva_master__v": true,
                        "thoroughfare__v": "Bob Wilson Dr",
                        "status_update_time__v": "2017-12-20T00:18:20.000Z",
                        "address_type__v": "P",
                        "delivery_address_1__v": "34800 Bob Wilson Dr",
                        "sub_administrative_area__v": "San Diego",
                        "entity_type__v": "HCP",
                        "address_verification_status__v": "V",
                        "address_status__v": "I",
                        "modified_date__v": "2017-12-20T00:18:20.000Z",
                        "record_state__v": "VALID",
                        "vid__v": "243244052365968387",
                        "entity_vid__v": "242980123077248009",
                        "postal_code__v": "92134-1098",
                        "is_externally_mastered__v": false,
                        "administrative_area__v": "US-CA",
                        "formatted_address__v": "34800 Bob Wilson Dr San Diego CA 92134-1098",
                        "latitude__v": 32.726315,
                        "address_ordinal__v": 3,
                        "postal_code_secondary__v": "1098",
                        "longitude__v": -117.143865
                    },
                    {
                        "dpv_confirmed_indicator__v": "X",
                        "postal_code_primary__v": "92614",
                        "address_line_1__v": "17010 Red Hill Ave Ste D",
                        "premise__v": "17010",
                        "cbsa__v": "31100",
                        "record_delta_id__v": "931585265015816197",
                        "thoroughfare_trailing_type__v": "Ave",
                        "locality__v": "Irvine",
                        "delivery_address__v": "17010 Red Hill Ave Ste D",
                        "country__v": "US",
                        "sub_building_number__v": "D",
                        "created_date__v": "2017-12-20T00:18:20.000Z",
                        "premise_number__v": "17010",
                        "is_veeva_master__v": true,
                        "sub_building_type__v": "Ste",
                        "sub_building__v": "Ste D",
                        "thoroughfare__v": "Red Hill Ave",
                        "status_update_time__v": "2017-12-20T00:18:20.000Z",
                        "address_type__v": "P",
                        "delivery_address_1__v": "17010 Red Hill Ave Ste D",
                        "sub_administrative_area__v": "Orange",
                        "entity_type__v": "HCP",
                        "address_verification_status__v": "V",
                        "address_status__v": "A",
                        "modified_date__v": "2017-12-20T00:18:20.000Z",
                        "record_state__v": "VALID",
                        "vid__v": "412146222338511876",
                        "entity_vid__v": "242980123077248009",
                        "postal_code__v": "92614-5626",
                        "is_externally_mastered__v": false,
                        "administrative_area__v": "US-CA",
                        "formatted_address__v": "17010 Red Hill Ave Ste D Irvine CA 92614-5626",
                        "latitude__v": 33.699966,
                        "address_ordinal__v": 2,
                        "thoroughfare_name__v": "Red Hill",
                        "postal_code_secondary__v": "5626",
                        "longitude__v": -117.848743
                    },
                    {
                        "dpv_confirmed_indicator__v": "X",
                        "postal_code_primary__v": "92647",
                        "address_line_1__v": "16071 Goldenwest St",
                        "premise__v": "16071",
                        "cbsa__v": "31100",
                        "record_delta_id__v": "931585265015816196",
                        "thoroughfare_trailing_type__v": "St",
                        "locality__v": "Huntington Beach",
                        "delivery_address__v": "16071 Goldenwest St",
                        "country__v": "US",
                        "created_date__v": "2017-12-20T00:18:20.000Z",
                        "premise_number__v": "16071",
                        "is_veeva_master__v": true,
                        "thoroughfare__v": "Goldenwest St",
                        "status_update_time__v": "2017-12-20T00:18:20.000Z",
                        "address_type__v": "P",
                        "delivery_address_1__v": "16071 Goldenwest St",
                        "sub_administrative_area__v": "Orange",
                        "entity_type__v": "HCP",
                        "address_verification_status__v": "V",
                        "address_status__v": "A",
                        "modified_date__v": "2017-12-20T00:18:20.000Z",
                        "record_state__v": "VALID",
                        "vid__v": "420505979138970626",
                        "entity_vid__v": "242980123077248009",
                        "postal_code__v": "92647-3405",
                        "is_externally_mastered__v": false,
                        "administrative_area__v": "US-CA",
                        "formatted_address__v": "16071 Goldenwest St Huntington Beach CA 92647-3405",
                        "latitude__v": 33.728098,
                        "address_ordinal__v": 1,
                        "thoroughfare_name__v": "Goldenwest",
                        "postal_code_secondary__v": "3405",
                        "longitude__v": -118.006864
                    }
                ],
                "parent_hcos__v": [
                    {
                        "parent_hco_vid__v": "242976933049009153",
                        "related_entity_type__v": "HCO",
                        "relationship_type__v": "9",
                        "status_update_time__v": "2017-12-20T00:18:20.000Z",
                        "record_delta_id__v": "931585265015816194",
                        "entity_type__v": "HCP",
                        "hierarchy_type__v": "HCP_HCO",
                        "modified_date__v": "2017-12-20T00:18:20.000Z",
                        "parent_hco_corp_name__v": "Navy Medical Center San Diego",
                        "record_state__v": "VALID",
                        "parent_hco_status__v": "A",
                        "is_primary_relationship__v": "N",
                        "vid__v": "243244052365968393",
                        "entity_vid__v": "242980123077248009",
                        "created_date__v": "2017-12-20T00:18:20.000Z",
                        "is_veeva_master__v": true
                    },
                    {
                        "parent_hco_vid__v": "242976933049009153",
                        "related_entity_type__v": "HCO",
                        "relationship_type__v": "9",
                        "status_update_time__v": "2017-12-20T00:18:20.000Z",
                        "record_delta_id__v": "931585265015816195",
                        "entity_type__v": "HCP",
                        "hierarchy_type__v": "HCP_HCO",
                        "modified_date__v": "2017-12-20T00:18:20.000Z",
                        "parent_hco_corp_name__v": "Navy Medical Center San Diego",
                        "record_state__v": "VALID",
                        "parent_hco_status__v": "I",
                        "is_primary_relationship__v": "N",
                        "vid__v": "315989759472276482",
                        "entity_vid__v": "242980123077248009",
                        "created_date__v": "2017-12-20T00:18:20.000Z",
                        "end_date__v": "2014-06-17",
                        "is_veeva_master__v": true
                    }
                ]
            }
        },
        {
            "entityId": "933580259012116863",
            "entityType": "EMPLOYEE__C",
            "metaData": {
                "highlights": {
                    "employee_str_name__c": [
                        "<em>Daniel</em> Carter"
                    ]
                },
                "vid__v": "933580259012116863",
                "highlightTerms": [
                    "San Diego",
                    "Daniel"
                ],
                "relevance": 30.439014
            },
            "entity": {
                "employee_title__c": "Key Account Manager",
                "record_owner_type__v": "LOCAL",
                "employee_status__c": "A",
                "employee_business_unit__c": "Sales",
                "employee_number__c": "103",
                "employee_last_name__c": "Carter",
                "record_delta_id__v": "933580259060776959",
                "record_owner_name__v": "Local",
                "employee_name__c": "Daniel Carter",
                "primary_country__v": "US",
                "created_date__v": "2018-12-07T08:11:33.000Z",
                "employee_first_name__c": "Daniel",
                "employee_hire_date__c": "2018-12-01",
                "is_veeva_master__v": false,
                "status_update_time__v": "2018-12-07T08:11:33.000Z",
                "modified_date__v": "2018-12-07T08:11:33.000Z",
                "record_state__v": "VALID",
                "candidate_record__v": false,
                "record_version__v": 0,
                "vid__v": "933580259012116863",
                "is_externally_mastered__v": false,
                "custom_keys__v": [
                    {
                        "custom_key_value__v": "933580259012116863",
                        "custom_key_vid_key__v": "CUSTOMER__v/3/change_request:EMPLOYEE__C:933580259012116863",
                        "custom_key_source_type__v": "CUSTOMER__v/3/change_request",
                        "custom_key_entity_type__v": "EMPLOYEE__C",
                        "custom_key_status__v": "A",
                        "status_update_time__v": "2018-12-07T08:11:33.000Z",
                        "custom_key_entity_id__v": "933580259012116863",
                        "custom_key_item_type__v": "EMPLOYEE__C",
                        "modified_date__v": "2018-12-07T08:11:33.000Z",
                        "vid__v": "933580259018867071",
                        "created_date__v": "2018-12-07T08:11:33.000Z"
                    },
                    {
                        "custom_key_value__v": "933580258951365023",
                        "custom_key_vid_key__v": "WORKFLOW__v:DCRID__v:933580258951365023",
                        "custom_key_source_type__v": "WORKFLOW__v",
                        "custom_key_entity_type__v": "EMPLOYEE__C",
                        "custom_key_status__v": "A",
                        "status_update_time__v": "2018-12-07T08:11:33.000Z",
                        "custom_key_entity_id__v": "933580259012116863",
                        "custom_key_item_type__v": "DCRID__v",
                        "modified_date__v": "2018-12-07T08:11:33.000Z",
                        "vid__v": "933580259019194751",
                        "created_date__v": "2018-12-07T08:11:33.000Z"
                    }
                ],
                "addresses__v": [
                    {
                        "nwk_primary_address__c": "Y",
                        "address_line_1__v": "200 Park Blvd.",
                        "record_owner_type__v": "LOCAL",
                        "record_delta_id__v": "933580259020275711",
                        "record_owner_name__v": "Local",
                        "locality__v": "San Diego",
                        "country__v": "US",
                        "created_date__v": "2018-12-07T08:11:33.000Z",
                        "is_veeva_master__v": false,
                        "status_update_time__v": "2018-12-07T08:11:33.000Z",
                        "address_type__v": "P",
                        "entity_type__v": "EMPLOYEE__C",
                        "address_verification_status__v": "DS",
                        "address_status__v": "A",
                        "modified_date__v": "2018-12-07T08:11:33.000Z",
                        "record_state__v": "VALID",
                        "vid__v": "933580259012116864",
                        "entity_vid__v": "933580259012116863",
                        "postal_code__v": "91915",
                        "administrative_area__v": "US-CA",
                        "formatted_address__v": "200 Park Blvd. San Diego US-CA 91915",
                        "address_ordinal__v": 1,
                        "custom_keys__v": []
                    }
                ],
                "employee_account_rel_rel_set__c": [
                    {
                        "employee_account_rel_rel_status__c": "A",
                        "record_owner_type__v": "LOCAL",
                        "status_update_time__v": "2018-12-07T08:11:33.000Z",
                        "related_entity_vid__v": "242976972248974337",
                        "related_entity_name__v": "Kindred Hospital San Diego",
                        "record_delta_id__v": "933580259020275712",
                        "entity_type__v": "EMPLOYEE__C",
                        "record_owner_name__v": "Local",
                        "modified_date__v": "2018-12-07T08:11:33.000Z",
                        "record_state__v": "VALID",
                        "is_primary_relationship__v": "N",
                        "vid__v": "933580259012116865",
                        "entity_vid__v": "933580259012116863",
                        "created_date__v": "2018-12-07T08:11:33.000Z",
                        "is_veeva_master__v": false,
                        "custom_keys__v": []
                    }
                ]
            }
        }
    ],
    "totalCount": 2,
    "offset": 0,
    "limit": 10,
    "supplementalResults": [
        {
            "hco_type__v": "4:6",
            "master_vid__v": "242976933049009153",
            "lab_services__v": "U",
            "hco_status__v": "A",
            "accept_medicare__v": "U",
            "npi_num__v": "1508036112",
            "count_all_locn_medstaff__v": 4,
            "record_delta_id__v": "931585265542594570",
            "count_non_md_do__v": 0,
            "kaiser__v": "N",
            "primary_country__v": "US",
            "hin__v": "930600I",
            "created_date__v": "2017-12-20T00:18:28.000Z",
            "training_facility__v": "N",
            "is_veeva_master__v": true,
            "major_class_of_trade__v": "4",
            "count_medstaff__v": 4,
            "count_md_do__v": 4,
            "ama_do_not_contact__v": "N",
            "count_all_locn_md_do__v": 4,
            "corporate_name__v": "Navy Medical Center San Diego",
            "status_update_time__v": "2017-12-20T00:18:27.000Z",
            "ams_id__v": "1324471",
            "modified_date__v": "2017-12-20T00:18:28.000Z",
            "accept_medicaid__v": "U",
            "record_state__v": "VALID",
            "count_all_locn_non_md_do__v": 0,
            "record_version__v": 0,
            "vid__v": "242976933049009153",
            "is_externally_mastered__v": false,
            "xray_services__v": "U",
            "roster_date__v": "2005-06-30",
            "licenses__v": [],
            "addresses__v": [
                {
                    "dpv_confirmed_indicator__v": "X",
                    "postal_code_primary__v": "92134",
                    "address_line_1__v": "34800 Bob Wilson Dr Ste 113",
                    "premise__v": "34800",
                    "cbsa__v": "41740",
                    "record_delta_id__v": "931585265542594574",
                    "thoroughfare_trailing_type__v": "Dr",
                    "locality__v": "San Diego",
                    "delivery_address__v": "34800 Bob Wilson Dr Ste 113",
                    "country__v": "US",
                    "sub_building_number__v": "113",
                    "created_date__v": "2017-12-20T00:18:28.000Z",
                    "premise_number__v": "34800",
                    "phone_1__v": "6195326397",
                    "is_veeva_master__v": true,
                    "sub_building_type__v": "Ste",
                    "sub_building__v": "Ste 113",
                    "fax_1__v": "6195326645",
                    "thoroughfare__v": "Bob Wilson Dr",
                    "status_update_time__v": "2017-12-20T00:18:28.000Z",
                    "address_type__v": "P",
                    "delivery_address_1__v": "34800 Bob Wilson Dr Ste 113",
                    "sub_administrative_area__v": "San Diego",
                    "entity_type__v": "HCO",
                    "address_verification_status__v": "V",
                    "address_status__v": "A",
                    "modified_date__v": "2017-12-20T00:18:28.000Z",
                    "record_state__v": "VALID",
                    "vid__v": "243244004894835806",
                    "entity_vid__v": "242976933049009153",
                    "postal_code__v": "92134-1113",
                    "is_externally_mastered__v": false,
                    "administrative_area__v": "US-CA",
                    "formatted_address__v": "34800 Bob Wilson Dr Ste 113 San Diego CA 92134-1113",
                    "latitude__v": 32.726315,
                    "address_ordinal__v": 1,
                    "thoroughfare_name__v": "Bob Wilson",
                    "postal_code_secondary__v": "1113",
                    "longitude__v": -117.143865
                }
            ],
            "parent_hcos__v": [
                {
                    "parent_hco_vid__v": "242977624605852672",
                    "related_entity_type__v": "HCO",
                    "relationship_type__v": "7341",
                    "status_update_time__v": "2017-12-20T00:18:28.000Z",
                    "record_delta_id__v": "931585265542594571",
                    "entity_type__v": "HCO",
                    "hierarchy_type__v": "HCO_HCO",
                    "modified_date__v": "2017-12-20T00:18:28.000Z",
                    "record_state__v": "VALID",
                    "parent_hco_status__v": "A",
                    "is_primary_relationship__v": "N",
                    "vid__v": "243244004894835805",
                    "entity_vid__v": "242976933049009153",
                    "created_date__v": "2017-12-20T00:18:28.000Z",
                    "is_veeva_master__v": true
                },
                {
                    "parent_hco_vid__v": "732072624842183680",
                    "related_entity_type__v": "HCO",
                    "relationship_type__v": "2",
                    "parent_type__v": "B",
                    "status_update_time__v": "2017-12-20T00:18:28.000Z",
                    "record_delta_id__v": "931585265542594573",
                    "entity_type__v": "HCO",
                    "hierarchy_type__v": "HCO_HCO",
                    "modified_date__v": "2017-12-20T00:18:28.000Z",
                    "record_state__v": "VALID",
                    "parent_hco_status__v": "A",
                    "is_primary_relationship__v": "N",
                    "vid__v": "738732591502431241",
                    "entity_vid__v": "242976933049009153",
                    "created_date__v": "2017-12-20T00:18:28.000Z",
                    "is_veeva_master__v": true
                }
            ]
        }
    ]
}

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" 'https://my.veevanetwork.com/api/v33.0/search?q=Michael&types=HCP&returnHashtagsForType=ALL&&filters=primary_country__v:US'

{
	"responseStatus": "SUCCESS",
	"entities": [{
			"entityId": "243215269164483592",
			"entityType": "HCP",
			"metaData": {
				"vid__v": "243215269164483592",
				"relevance": 164.14282
			},
			"entity": {
				"first_name__v": "Michael",
				"years_in_progress__v": 0,
				"birth_year__v": 1949,
				...
				"parent_hcos__v": [{
						"parent_hco_vid__v": "670748077530911744",
						...
					}
				]
			},
			"hashtags": [{
				"name": "#npi",
				"color": "gray",
				"tooltip": "HCP or HCO has an NPI number",
				"tooltipLabel": "NPI: ",
				"tooltipValue": "1487655437",
				"tooltipHasOtherValue": false
			}]
		},
		....

Managing subscriptions

The system interfaces APIs enable you to manage source and target subscriptions that import and export data to and from Network.

With these APIs you can retrieve information about systems, subscriptions, and corresponding jobs.

Create a subscription job

This API enables you to create a subscription job.

This API requires system administrator or API-only permission.

Endpoint URL

https://DNS/api/version/subscription/subscription_name/job

DNS - is the URL for your API service
version - is the API version
subscription_name - The name of the subscription.

The following parameters are supported for source subscriptions:

Optional Parameters

mode

Enable one of the following behaviors:

save_changes - Save changes to the database.

test_mode - Run the job in test mode only.

simulation_mode - Run the job in simulation mode.

default - Run the subscription using the current subscription configuration.

This parameter does not change the subscription configuration.

The following parameters are supported for target subscriptions;

Optional Parameters
data_revision_first: The start data revision for the job.
data_revision_last: The end data revision for the job.
apply_data_revisions_for_delta_export_only: Apply the other data revision parameters to delta exports only.

curl -X POST -H "Authorization: 8B0419FB7885B7D765A919CFF7178D1B61835CCD1CD19CA15701DED9267984F783A66DFF255DB7A8B5AB9259B102A7C7DFCF9407C9ACBB6A9500B2345694021AC4693F3F7C588B2C8C5681882378FB7B" https://my.network.com/api/v33.0/subscription/CRM_Import/job

{
  "job_id" : 87,
  "responseStatus" : "SUCCESS"
}

Cancel a subscription job

This API enables you to cancel a subscription job.

This API requires system administrator or API-only permission.

Endpoint URL

https://DNS/api/version/job/job_id

DNS - is the URL for your API service
version - is the API version
job_id - The unique ID of the job.

This API takes no parameters.

Response
responseStatus: The status of the response.

Notes

This API will fail if:

The job ID cannot be found.
The status of the job is not ACTIVE, SUSPENDED, or STOPPING.

Since the request to cancel the job is asynchronous, the request might be unsuccessful, regardless of these specific cases.

curl -X DELETE -H "Authorization: 8B0419FB7885B7D765A919CFF7178D1B61835CCD1CD19CA15701DED9267984F783A66DFF255DB7A8B5AB9259B102A7C7DFCF9407C9ACBB6A9500B2345694021AC4693F3F7C588B2C8C5681882378FB7B"https://my.network.com/api/v33.0/job/87

{
  "responseStatus": "SUCCESS"
}

Retrieve a subscription job status

This API enables you to retrieve the status of a source or target subscription job.

Endpoint URL

https://DNS/api/version/job/job_id

DNS - is the URL for your API service
version - is the API version
job_id - The unique ID of the job.

This API takes no parameters.

Response
responseStatus: The status of the response.
subscriptionId: The ID of the subscription.
subscriptionName: The name of the subscription.
durationInMilliseconds: The total duration of the job.
type: The type of job; for example, manual for a manually run subscription.
errorCount: The total number of errors.
badRecordCount: The total number of bad records.
recordCount: The total number of records.
filesProcessed: The total number of files processed.
dataLoadSummary: For each object type:

The number of rows read.

The number of rows parsed.
processedDataSummary: The total number of rows processed for each entity type.
matchSummary: The total match results for each entity type.

The number of entities that did not match.

The number of entities that matched and were automatically merged.

The number of entities that are suspect matches.
jobResultSummary: The total number of records processed, added, and merged for each entity type.

The total number of records successfully added.

The number of new records added.

The number of records updated.

The number of records merged into existing records.

The number of records invalidated.

The number of records not loaded.
job_id: The unique ID of the job generated for the subscription you specified.
job_status: The status of the job for the specified subscription.

ACTIVE - The job is running.

CANCELED - The job was canceled by the user and can be resumed if a checkpoint exists.

COMPLETE - The job has completed successfully.

FAILED - The job has failed and can be resumed if a checkpoint exists.

INTERRUPTED - The job was stopped because the system entered maintenance mode while it was active. It will resume when maintenance mode is exited or on reboot.

KILLED - The job was killed by the user and cannot be resumed.

NEW - The initial job state prior to scheduling.

PARKED - The job has been unscheduled and will not be rescheduled until a resume. Mutex restrictions will not be honored by the scheduler and traffic with similar mutex restrictions will not be blocked.

PAUSED - The job has been unscheduled and will not be rescheduled until a resume. Mutex restrictions will be honored by the scheduler and traffic with similar mutex restrictions will be blocked.

STOPPING - The job has been signaled to stop but is still active.

SUSPENDED - The job is scheduled and is waiting for shared resources prior to becoming active.
created_date: The date the job was created in GMT.
completed_date: The date and time the job completed.

curl -X GET -H "Authorization: 8B0419FB7885B7D765A919CFF7178D1B61835CCD1CD19CA15701DED9267984F783A66DFF255DB7A8B5AB9259B102A7C7DFCF9407C9ACBB6A9500B2345694021AC4693F3F7C588B2C8C5681882378FB7B" https://my.network.com/api/v33.0/job/87

{
   "errorCount" : 0,
   "type" : "MANUAL",
   "subscriptionId" : 80,
   "completed_date" : "2018-05-09T08:09:50.000Z",
   "recordCount" : 0,
   "job_status" : "COMPLETE",
   "jobResultSummary" : {
      "ADDRESS" : {
         "recordsUpdated" : 1,
         "recordsInvalidated" : 0,
         "total" : 32,
         "recordsSkipped" : 0,
         "newRecordsAdded" : 31,
         "recordsMerged" : 0
      },
      "CUSTOMKEY" : {
         "recordsInvalidated" : 0,
         "recordsUpdated" : 2,
         "total" : 71,
         "recordsSkipped" : 0,
         "recordsMerged" : 0,
         "newRecordsAdded" : 69
      },
      "HCP" : {
         "recordsSkipped" : 0,
         "total" : 14,
         "recordsUpdated" : 0,
         "recordsInvalidated" : 0,
         "recordsMerged" : 0,
         "newRecordsAdded" : 14
      },
      "HCO" : {
         "recordsSkipped" : 0,
         "total" : 2,
         "recordsUpdated" : 2,
         "recordsInvalidated" : 0,
         "newRecordsAdded" : 0,
         "recordsMerged" : 0
      },
      "LICENSE" : {
         "total" : 19,
         "recordsSkipped" : 0,
         "recordsUpdated" : 0,
         "recordsInvalidated" : 0,
         "newRecordsAdded" : 19,
         "recordsMerged" : 0
      },
      "PARENTHCO" : {
         "newRecordsAdded" : 5,
         "recordsMerged" : 0,
         "recordsUpdated" : 0,
         "recordsInvalidated" : 0,
         "total" : 5,
         "recordsSkipped" : 0
      }
   },
   "processedDataSummary" : {
      "PARENTHCO" : 25,
      "HCO" : 2,
      "LICENSE" : 20,
      "ADDRESS" : 38,
      "HCP" : 14
   },
   "subscriptionName" : "CRM_Import",
   "badRecordCount" : 0,
   "job_id" : 87,
   "created_date" : "2018-05-09T08:08:50.000Z",
   "responseStatus" : "SUCCESS",
   "filesProcessed" : 0,
   "durationInMilliseconds" : 60000
}

Create a source subscription job

This API enables you to create a source subscription job.

This API requires system administrator or API-only permission.

Endpoint URL

https://DNS/api/version/systems/system_name/source_subscriptions/subscription_name/job

DNS - is the URL for your API service
version - is the API version
system_name - The unique name of the system.
subscription_name - The name of the subscription.

Optional Parameters

mode

Enable one of the following behaviors:

save_changes - Save changes to the database.

test_mode - Run the job in test mode only.

simulation_mode - Run the job in simulation mode.

default - Run the subscription using the current subscription configuration.

This parameter does not change the subscription configuration.

Response
responseStatus: The status of the response.
jobId: The unique ID of the job generated for the subscription you specified.

curl -X POST -H "Authorization: 8B0419FB7885B7D765A919CFF7178D1B61835CCD1CD19CA15701DED9267984F783A66DFF255DB7A8B5AB9259B102A7C7DFCF9407C9ACBB6A9500B2345694021AC4693F3F7C588B2C8C5681882378FB7B" https://my.veevanetwork.com/api/v33.0/systems/CRM_System/source_subscriptions/CRM_Import/job

{
  "job_id" : 10543,
  "responseStatus" : "SUCCESS"
}

Cancel a source subscription job

This API enables you to cancel a source subscription job.

This API requires system administrator or API-only permission.

https://DNS/api/version/systems/system_name/source_subscriptions/subscription_name/job/job_id

DNS - is the URL for your API service
version - is the API version
system_name - The unique name of the system.
subscription_name - The name of the subscription.
job_id - The unique ID of the job.

This API takes no parameters.

Response
responseStatus: The status of the response.

curl -X DELETE -H "Authorization: 8B0419FB7885B7D765A919CFF7178D1B61835CCD1CD19CA15701DED9267984F783A66DFF255DB7A8B5AB9259B102A7C7DFCF9407C9ACBB6A9500B2345694021AC4693F3F7C588B2C8C5681882378FB7B" https://my.veevanetwork.com/api/v33.0/systems/CRM_System/source_subscriptions/CRM_Import/job/10543

{
  "responseStatus": "SUCCESS"
}

Retrieve a source subscription job status

This API enables you to retrieve the status of a source subscription job.

Endpoint URL

https://DNS/api/version/systems/system_name/source_subscriptions/subscription_name/job/job_id

DNS - is the URL for your API service
version - is the API version
system_name - The unique name of the system.
subscription_name - The name of the subscription.
job_id - The unique ID of the job.

This API takes no parameters.

Response
responseStatus: The status of the response.
subscriptionId: The ID of the subscription.
subscriptionName: The name of the subscription.
durationInMilliseconds: The total duration of the job.
type: The type of job; for example, manual for a manually run subscription.
errorCount: The total number of errors.
badRecordCount: The total number of bad records.
recordCount: The total number of records.
filesProcessed: The total number of files processed.
dataLoadSummary: For each object type:

The number of rows read.

The number of rows parsed.
processedDataSummary: The total number of rows processed for each entity type.
matchSummary: The total match results for each entity type.

The number of entities that did not match.

The number of entities that matched and were automatically merged.

The number of entities that are suspect matches.
jobResultSummary: The total number of records processed, added, and merged for each entity type.

The total number of records successfully added.

The number of new records added.

The number of records updated.

The number of records merged into existing records.

The number of records invalidated.

The number of records not loaded.
job_id: The unique ID of the job generated for the subscription you specified.
job_status: The status of the job for the specified subscription.

ACTIVE - The job is running.

CANCELED - The job was canceled by the user and can be resumed if a checkpoint exists.

COMPLETE - The job has completed successfully.

FAILED - The job has failed and can be resumed if a checkpoint exists.

INTERRUPTED - The job was stopped because the system entered maintenance mode while it was active. It will resume when maintenance mode is exited or on reboot.

KILLED - The job was killed by the user and cannot be resumed.

NEW - The initial job state prior to scheduling.

PARKED - The job has been unscheduled and will not be rescheduled until a resume. Mutex restrictions will not be honored by the scheduler and traffic with similar mutex restrictions will not be blocked.

PAUSED - The job has been unscheduled and will not be rescheduled until a resume. Mutex restrictions will be honored by the scheduler and traffic with similar mutex restrictions will be blocked.

STOPPING - The job has been signaled to stop but is still active.

SUSPENDED - The job is scheduled and is waiting for shared resources prior to becoming active.
created_date: The date the job was created in GMT.
completed_date: The date and time the job completed.

curl -X GET -H "Authorization: 8B0419FB7885B7D765A919CFF7178D1B61835CCD1CD19CA15701DED9267984F783A66DFF255DB7A8B5AB9259B102A7C7DFCF9407C9ACBB6A9500B2345694021AC4693F3F7C588B2C8C5681882378FB7B" https://my.veevanetwork.com/api/v33.0/systems/CRM_System/source_subscriptions/CRM_Import/job/10537

{
   "filesProcessed" : 1,
   "errorCount" : 0,
   "subscriptionName" : "CRM_Import",
   "completed_date" : "2019-12-18T22:42:32.000Z",
   "job_status" : "COMPLETE",
   "job_id" : 10537,
   "jobResultSummary" : {
      "CUSTOMKEY" : {
         "total" : 2,
         "recordsUpdated" : 0,
         "recordsSkipped" : 2,
         "newRecordsAdded" : 0,
         "recordsInvalidated" : 0,
         "recordsMerged" : 0
      },
      "HCP" : {
         "total" : 1,
         "recordsUpdated" : 0,
         "recordsSkipped" : 1,
         "recordsMerged" : 0,
         "recordsInvalidated" : 0,
         "newRecordsAdded" : 0
      },
      "ADDRESS" : {
         "total" : 1,
         "recordsUpdated" : 0,
         "recordsSkipped" : 1,
         "recordsInvalidated" : 0,
         "newRecordsAdded" : 0,
         "recordsMerged" : 0
      }
   },
   "durationInMilliseconds" : 3000,
   "created_date" : "2019-12-18T22:42:29.000Z",
   "subscriptionId" : 117,
   "processedDataSummary" : {
      "HCP" : 1,
      "ADDRESS" : 1
   },
   "type" : "MANUAL",
   "dataLoadSummary" : {
      "ADDRESS" : {
         "rowsRead" : 1,
         "rowsParsed" : 1
      },
      "HCP" : {
         "rowsParsed" : 1,
         "rowsRead" : 1
      }
   },
   "badRecordCount" : 0,
   "recordCount" : 2,
   "matchSummary" : {
      "HCP" : {
         "ACT" : 1,
         "notMatched" : 0,
         "ASK" : 0
      },
      "HCO" : {
         "ACT" : 0,
         "notMatched" : 0,
         "ASK" : 0
      }
   },
   "responseStatus" : "SUCCESS"
}

Create a target subscription job

This API enables you to create a target subscription job.

This API requires system administrator or API-only permission.

Endpoint URL

https://DNS/api/version/systems/system_name/target_subscriptions/subscription_name/job

DNS - is the URL for your API service
version - is the API version
system_name - The unique name of the system.
subscription_name - The name of the subscription.

Optional Parameters
data_revision_first: The start data revision for the job.
data_revision_last: The end data revision for the job.
apply_data_revisions_for_delta_export_only: Apply the other data revision parameters to delta exports only.

If True with data_revision_first specified, the target subscription will only run as a delta export if it is configured as a delta export.

If False with data_revision_last specified, the target subscription will run as a delta export.

The default is False.
export_archive: To avoid job timeouts you can set this parameter to split to split the export files. The maximum file size with this option set is 1GB.

curl -X POST -H "Authorization: 0F7FCD0FAF2A76893CCB286551DE4587C24166A9004740BE8ADD4594D3C87AB00CE90E0D19276D4C2733601D311C0AFB7346B8C9A3728B0FD823D4147BF4CD53E47729F90611CA3899E574B322CAC236" https://my.veevanetwork.com/api/v33.0/systems/customer/target_subscriptions/FullExport/job

{
  "job_id" : 10563,
  "responseStatus" : "SUCCESS"
}

Cancel a target subscription job

This API enables you to cancel a target subscription job.

This API requires system administrator or API-only permission.

Endpoint URL

https://DNS/api/version/systems/system_name/target_subscriptions/subscription_name/job/job_id

DNS - is the URL for your API service
version - is the API version
system_name - The unique name of the system.
subscription_name - The name of the subscription.
job_id - The unique ID of the job.

This API takes no parameters.

Response
responseStatus: The status of the response.

Notes

This API will fail if:

The system, subscription, or job ID cannot be found.
The system, subscription, or job ID do not match the request.
The status of the job is not ACTIVE, SUSPENDED, or STOPPING.

Since the request to cancel the job is asynchronous, the request might be unsuccessful, regardless of these specific cases.

curl -X DELETE -H "Authorization: 0F7FCD0FAF2A76893CCB286551DE4587C24166A9004740BE8ADD4594D3C87AB00CE90E0D19276D4C2733601D311C0AFB7346B8C9A3728B0FD823D4147BF4CD53E47729F90611CA3899E574B322CAC236" https://my.veevanetwork.com/api/v33.0/systems/customer/target_subscriptions/FullExport/job/10563

{
  "responseStatus": "SUCCESS"
}

Retrieve target subscription artifact

This API enables you to retrieve the artifacts (file contents) of a target subscription job.

Endpoint URL

https://DNS/api/version/artifact/job/job_id/filename

DNS - is the URL for your API service
version - is the API version
job_id - The unique ID of the job.
filename - is the name of the .csv file to retrieve

This API takes no parameters.

The response returns the contents of the requested file.

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" https://my.veevanetwork.com/api/v33.0/artifact/job/228/hcp_0001.csv

"vid__v","first_name__v","middle_name__v","last_name__v","hcp_status__v","specialty_1__v","medical_degree_1__v","record_state__v"
"242993418349839362","Zachary","R","Thomas","A","AN","MD","VALID"
"243082079594611713","Dean","T","Lopez","A","PHT","PT","VALID"
"243090311377585154","Lori Lynn",,"Baylor","I","US","RN","VALID"
"243100754808669185","Gerri","Thomas","Engrid","A","AN","NP","VALID"
"243133377207600136","Sandra","Susan","Leaf","A","GP","RN","VALID"
"243143545802720257","Iara","Del Mar","Iglesias","A","OBG","MD","VALID"
"243154001430840328","Alai",,"Alvarado","A","EM","MD","VALID"
"243161953747338249","Marcus","Karlan","Park","A","PMM","MD","VALID"
"243163308230706170","Alfred","Oh","May","A","AI","MD","VALID"

Retrieve a target subscription job status

This API enables you to retrieve the status of a source or target subscription job.

Endpoint URL

https://DNS/api/version/systems/system_name/target_subscriptions/subscription_name/job/job_id

DNS - is the URL for your API service
version - is the API version
system_name - The unique name of the system.
subscription_name - The name of the subscription.
job_id - The unique ID of the job.

This API takes no parameters.

Response
responseStatus: The status of the response.
subscriptionId: The ID of the subscription.
subscriptionName: The name of the subscription.
durationInMilliseconds: The total duration of the job.
type: The type of job; for example, manual for a manually run subscription.
errorCount: The total number of errors.
badRecordCount: The total number of bad records.
exportHCPCount: The number of HCPs exported.
exportHCOCount: The number of HCOs exported.
exportAddrCount: The number of addresses exported.
exportLicenseCount: The number of licenses exported.
exportParentHCOCount: The number of parent HCOs exported.
exportCustomKeyCount: The number of custom keys exported.
exportReferenceCount: The number of reference data values exported.
exportFull: Whether or not the job is a full data export.
exportReferenceVersion: The version for the reference data file.
exportActiveOnly: Whether or not active records should be exported only.
exportEncoding: The encoding of the export file; for example, UTF-8.
job_id: The unique ID of the job generated for the subscription you specified.
job_status: The status of the job for the specified subscription.

ACTIVE - The job is running.

CANCELED - The job was canceled by the user and can be resumed if a checkpoint exists.

COMPLETE - The job has completed successfully.

FAILED - The job has failed and can be resumed if a checkpoint exists.

INTERRUPTED - The job was stopped because the system entered maintenance mode while it was active. It will resume when maintenance mode is exited or on reboot.

KILLED - The job was killed by the user and cannot be resumed.

NEW - The initial job state prior to scheduling.

PARKED - The job has been unscheduled and will not be rescheduled until a resume. Mutex restrictions will not be honored by the scheduler and traffic with similar mutex restrictions will not be blocked.

PAUSED - The job has been unscheduled and will not be rescheduled until a resume. Mutex restrictions will be honored by the scheduler and traffic with similar mutex restrictions will be blocked.

STOPPING - The job has been signaled to stop but is still active.

SUSPENDED - The job is scheduled and is waiting for shared resources prior to becoming active.
created_date: The date the job was created in GMT.
data_revision_first: The start data revision for the job.
data_revision_last: The end data revision for the job.
export_package_path: The export file location including the file name.
total_records_exported: The total number of records exported.
completed_date: The date and time the job completed.
jobExportCount: The list of exported entity and child counts. Replaces the following fields:

exportHCPCount

exportHCOCount

exportAddrCount

exportLicenseCount

exportParentHCOCount

exportCustomKeyCount

Notes

If no revisions exist in the given range:

data_revision_first will be used for the change request.
data_revision_last = 0.

curl -X GET -H "Authorization: 0F7FCD0FAF2A76893CCB286551DE4587C24166A9004740BE8ADD4594D3C87AB00CE90E0D19276D4C2733601D311C0AFB7346B8C9A3728B0FD823D4147BF4CD53E47729F90611CA3899E574B322CAC236" https://my.veevanetwork.com/api/v33.0/systems/customer/target_subscriptions/FullExport/job/10563

{
   "errorCount" : 0,
   "type" : "MANUAL",
   "subscriptionId" : 80,
   "completed_date" : "2019-12-19T18:59:55.000Z",
   "recordCount" : 0,
   "job_status" : "COMPLETE",
   "jobResultSummary" : {
      "ADDRESS" : {
         "recordsUpdated" : 1,
         "recordsInvalidated" : 0,
         "total" : 32,
         "recordsSkipped" : 0,
         "newRecordsAdded" : 31,
         "recordsMerged" : 0
      },
      "CUSTOMKEY" : {
         "recordsInvalidated" : 0,
         "recordsUpdated" : 2,
         "total" : 71,
         "recordsSkipped" : 0,
         "recordsMerged" : 0,
         "newRecordsAdded" : 69
      },
      "HCP" : {
         "recordsSkipped" : 0,
         "total" : 14,
         "recordsUpdated" : 0,
         "recordsInvalidated" : 0,
         "recordsMerged" : 0,
         "newRecordsAdded" : 14
      },
      "HCO" : {
         "recordsSkipped" : 0,
         "total" : 2,
         "recordsUpdated" : 2,
         "recordsInvalidated" : 0,
         "newRecordsAdded" : 0,
         "recordsMerged" : 0
      },
      "LICENSE" : {
         "total" : 19,
         "recordsSkipped" : 0,
         "recordsUpdated" : 0,
         "recordsInvalidated" : 0,
         "newRecordsAdded" : 19,
         "recordsMerged" : 0
      },
      "PARENTHCO" : {
         "newRecordsAdded" : 5,
         "recordsMerged" : 0,
         "recordsUpdated" : 0,
         "recordsInvalidated" : 0,
         "total" : 5,
         "recordsSkipped" : 0
      }
   },
   "processedDataSummary" : {
      "PARENTHCO" : 25,
      "HCO" : 2,
      "LICENSE" : 20,
      "ADDRESS" : 38,
      "HCP" : 14
   },
   "subscriptionName" : "FullExport",
   "badRecordCount" : 0,
   "job_id" : 10563,
   "created_date" : "2019-12-19T18:52:13.000Z",
   "responseStatus" : "SUCCESS",
   "filesProcessed" : 0,
   "durationInMilliseconds" : 60000
}

Create a compliance subscription job

This API enables you to create a compliance subscription job.

This API requires system administrator or API-only permission.

Endpoint URL

https://DNS/api/version/systems/compliance_subscriptions/subscription_name/job

DNS - is the URL for your API service
version - is the API version
subscription_name - The name of the subscription.

This API takes no parameters.

Response
responseStatus: The status of the response.
jobId: The unique ID of the job generated for the subscription you specified.

curl -X POST -H "Authorization: 0F7FCD0FAF2A76893CCB286551DE4587C24166A9004740BE8ADD4594D3C87AB00CE90E0D19276D4C2733601D311C0AFB7346B8C9A3728B0FD823D4147BF4CD53E47729F90611CA3899E574B322CAC236" https://my.veevanetwork.com/api/v33.0/systems/compliance_subscriptions/comp_us/job

{
  "responseStatus" : "SUCCESS",
  "job_id" : 10566
}

Cancel a compliance subscription job

This API enables you to cancel a compliance subscription job.

This API requires system administrator or API-only permission.

https://DNS/api/version/systems/compliance_subscriptions/subscription_name/job/job_id

DNS - is the URL for your API service
version - is the API version
subscription - (Undefined variable: Endpoint_parms.subscription)
job_id - The unique ID of the job.

This API takes no parameters.

Response
responseStatus: The status of the response.

Notes

This API will fail if:

The system, subscription, or job ID cannot be found.
The system, subscription, or job ID do not match the request.
The status of the job is not ACTIVE, SUSPENDED, or STOPPING.

Since the request to cancel the job is asynchronous, the request might be unsuccessful, regardless of these specific cases.

curl -X DELETE -H "Authorization: 0F7FCD0FAF2A76893CCB286551DE4587C24166A9004740BE8ADD4594D3C87AB00CE90E0D19276D4C2733601D311C0AFB7346B8C9A3728B0FD823D4147BF4CD53E47729F90611CA3899E574B322CAC236" https://my.veevanetwork.com/api/v33.0/systems/compliance_subscriptions/comp_us/job/10566

{
  "responseStatus": "SUCCESS"
}

Retrieve a compliance subscription job status

This API enables you to retrieve the status of a source or target subscription job.

Endpoint URL

https://DNS/api/version/systems/compliance_subscriptions/subscription_name/job/job_id

DNS - is the URL for your API service
version - is the API version
subscription - (Undefined variable: Endpoint_parms.subscription)
job_id - The unique ID of the job.

This API takes no parameters.

Response
responseStatus: The status of the response.
subscriptionId: The ID of the subscription.
subscriptionName: The name of the subscription.
durationInMilliseconds: The total duration of the job.
type: The type of job; for example, manual for a manually run subscription.
errorCount: The total number of errors.
badRecordCount: The total number of bad records.
crossReferenceDetails: An array of cross-reference counts.

object - The type of object referenced: HCO or HCP.

source - The compliance source.

count - The number of records returned.

matched - True if the count is the number of matched records; false if the count is the number of unmatched records.
job_id: The unique ID of the job generated for the subscription you specified.
job_status: The status of the job for the specified subscription.

ACTIVE - The job is running.

CANCELED - The job was canceled by the user and can be resumed if a checkpoint exists.

COMPLETE - The job has completed successfully.

FAILED - The job has failed and can be resumed if a checkpoint exists.

INTERRUPTED - The job was stopped because the system entered maintenance mode while it was active. It will resume when maintenance mode is exited or on reboot.

KILLED - The job was killed by the user and cannot be resumed.

NEW - The initial job state prior to scheduling.

PARKED - The job has been unscheduled and will not be rescheduled until a resume. Mutex restrictions will not be honored by the scheduler and traffic with similar mutex restrictions will not be blocked.

PAUSED - The job has been unscheduled and will not be rescheduled until a resume. Mutex restrictions will be honored by the scheduler and traffic with similar mutex restrictions will be blocked.

STOPPING - The job has been signaled to stop but is still active.

SUSPENDED - The job is scheduled and is waiting for shared resources prior to becoming active.
created_date: The date the job was created in GMT.
export_package_path: The export file location including the file name.
completed_date: The date and time the job completed.

curl -X GET -H "Authorization: 0F7FCD0FAF2A76893CCB286551DE4587C24166A9004740BE8ADD4594D3C87AB00CE90E0D19276D4C2733601D311C0AFB7346B8C9A3728B0FD823D4147BF4CD53E47729F90611CA3899E574B322CAC236" https://my.veevanetwork.com/api/v33.0/systems/compliance_subscriptions/comp_us/job/10566

{
    "responseStatus": "SUCCESS",
    "subscriptionId": 12,
    "subscriptionName": "comp_us",
    "durationInMilliseconds": 2000,
    "type": "COMPLIANCE",
    "errorCount": 0,
    "badRecordCount": 0,
    "crossReferenceDetails": [
        {
            "object": "HCO",
            "source": "NPI",
            "count": 2819,
            "matched": false
        },
        {
            "object": "HCP",
            "source": "SLN",
            "count": 1835,
            "matched": false
        },
        {
            "object": "HCP",
            "source": "SLN",
            "count": 13881,
            "matched": false
        },
        {
            "object": "HCO",
            "source": "CMS_TEACHING_HOSPITAL",
            "count": 826,
            "matched": false
        },
        {
            "object": "HCO",
            "source": "DEA",
            "count": 30,
            "matched": false
        },
        {
            "object": "HCP",
            "source": "NPI",
            "count": 6578,
            "matched": false
        },
        {
            "object": "HCP",
            "source": "DEA",
            "count": 106,
            "matched": false
        },
        {
            "object": "HCP",
            "source": "DEA",
            "count": 6263,
            "matched": false
        },
        {
            "object": "HCO",
            "source": "CMS_TEACHING_HOSPITAL",
            "count": 5532,
            "matched": false
        },
        {
            "object": "HCO",
            "source": "NPI",
            "count": 5730,
            "matched": false
        },
        {
            "object": "HCP",
            "source": "NPI",
            "count": 494,
            "matched": false
        },
        {
            "object": "HCO",
            "source": "DEA",
            "count": 44,
            "matched": false
        }
    ],
    "job_id": 10566,
    "job_status": "COMPLETE",
    "created_date": "2015-10-16T08:14:57.000-07:00",
    "export_package_path": "outbound/US_Compliance_Target_Subscription/source_data_150715T205219904_job_0000010C.zip",
    "completed_date": "2015-10-16T08:14:59.000-07:00"
}

Bulk exports

This tutorial details the steps required to perform and retrieve a bulk export from Veeva Network using the Network API.

The basic steps required are as follows

Authenticate with Network.
Create a target subscription job.
Check the status of the subscription job (optionaL).
Retrieve the results of the subscription job.

When initiating a bulk export, you'll need to know the system and subscription names in the Network instance you're calling.

Authenticating with Network

The Authenticate API enables user authentication. After the user is authenticated, a sessionId is returned by Network that must be used on subsequent API calls. The sessionId is valid for 20 minutes.

curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d \
'username=john.smith@my.veevanetwork.com&password=12345' \
"https://my.veevanetwork.com/api/v33.0/auth"

If the authentication is successful, the response will appear like this:

{
   "networkId" : "500",
   "sessionId" : "26154CB7CEC2C55EE9CD62048C4ECF896E8BF5F3671D040DB7BAF596DD5CF5F960E2C10DBF7D71EBF030C6E1269292F65E700E1361560F7D9EC6108091CBD2A2AB39BC60A23B72BB85F811E8F57B8BB4",
   "networkIds" : [
      {
         "name" : "MYVEEVA",
         "url" : "https://my.veevanetwork.com/api",
         "id" : 500
      }
   ],
   "userId" : 552,
   "responseStatus" : "SUCCESS"
}

Running the target subscription job

Once you've authenticated with Network, you use the session ID received from that call to start a bulk export job.

Here's the request:

curl -X POST -H "Authorization: 26154CB7CEC2C55EE9CD62048C4ECF896E8BF5F3671D040\
DB7BAF596DD5CF5F960E2C10DBF7D71EBF030C6E1269292F65E700E1361560F7D9EC6108091CBD2\
A2AB39BC60A23B72BB85F811E8F57B8BB4" https://my.veevanetwork.com/api/v33.0/systems\
/verteo/target_subscriptions/FullExport/job?export_archive=split

The export_archive option specifies that export files should be split to avoid job timeouts. The maximum file size with this option set is 1GB.

The result provides the job ID required for later steps:

{
    "job_id" : 1126,
    "responseStatus" : "SUCCESS"
}

The export job is now running.

Retrieving the target subscription job status

Depending on the size and type of the job, you might want to check the target job's status.

For this step, you'll need the system name, subscription name, and the job ID produced in the previous step.

curl -X GET -H "Authorization: 26154CB7CEC2C55EE9CD62048C4ECF896E8BF5F3671D040\
DB7BAF596DD5CF5F960E2C10DBF7D71EBF030C6E1269292F65E700E1361560F7D9EC6108091CBD2\
A2AB39BC60A23B72BB85F811E8F57B8BB4" https://my.veevanetwork.com/api/v33.0/systems\
/verteo/target_subscriptions/FullExport/job/1126

This produces the following result:

{
   "responseStatus":"SUCCESS",
   "job_id":1126,
   "job_status":"COMPLETE",
   "created_date":"2020-02-12T12:04:03.000-08:00",
   "data_revision_first":"0",
   "data_revision_last":"937744301078642687",
   "export_package_path":"outbound/verteo/FullExport/FullExport_210212T200403429",
   "total_records_exported":"45484",
   "subscriptionId":15,
   "subscriptionName":"FullExport",
   "completed_date":"2020-02-12T12:04:15.000-08:00",
   "durationInMilliseconds":120000,
   "type":"MANUAL",
   "errorCount":0,
   "badRecordCount":0,
   "exportReferenceCount":0,
   "exportFull":true,
   "exportIncludeReference":false,
   "exportUpdatedChildOnly":false,
   "exportSetSubscriptionStateOnFull":false,
   "exportFormat":"CSV",
   "exportReferenceVersion":"4",
   "exportActiveOnly":false,
   "exportPackageName":"FullExport_${timestamp}",
   "jobExportCount":{
      "PARENTHCO":2302,
      "HCP":499,
      "HCO":44985,
      "ADDRESS":46025
   },
   "exportFormatDelimiter":"\t",
   "exportFormatTextQualifier":"\"",
   "export_archive":"split",
   "jobExportLinks":[
      {
         "object":"parenthco",
         "href":"/artifact/job/1126/parenthco_0000.csv",
         "method":"GET",
         "accept":"text/csv"
      },
      {
         "object":"hcp",
         "href":"/artifact/job/1126/hcp_0000.csv",
         "method":"GET",
         "accept":"text/csv"
      },
      {
         "object":"hcp",
         "href":"/artifact/job/1126/hcp_0001.csv",
         "method":"GET",
         "accept":"text/csv"
      },
      {
         "object":"hco",
         "href":"/artifact/job/1126/hco_0000.csv",
         "method":"GET",
         "accept":"text/csv"
      },
      {
         "object":"address",
         "href":"/artifact/job/1126/address_0000.csv",
         "method":"GET",
         "accept":"text/csv"
      }
   ]
}

The status indicates that the job has completed successfully, and returns summaries for exported records.

Files for each entity are split automatically at 1GB intervals, and file names in turn are incremented by one; for example, hcp_0000.csv, hcp_0001.csv, and so on.

Retrieve the target subscription job results

Once your target subscription job has completed successfully, you can retrieve the contents of the files, or artifacts, for each entity exported in the job.

For this call, you'll need the job ID and file name produced in the previous steps; for example, to retrieve the HCPs from the target subscription job, you use the file name hcp_0000.csv produced in the previous step:

curl -X GET -H "Authorization: 2C2EE0B28E170EFEFEE94EC86F632CA01918905AC2E5E8\
F1914F36E0B532E59C6925DE52CC6EBB01C8DE35F355B9AF89E7B735437C8BB1AAA8212F35F6E17\
3737D7DF47DC6A9DC1D0229C5C2B17EDD94" https://my.veevanetwork.com/api/v33.0/artifact\
/job/68230/hcp_0000.csv > verteo_hcp_export.csv

This call outputs the contents of the export for HCPs to a local file named verteo_hcp_export.csv which you can open and view.

Repeat this step for each artifact as needed.

Was this helpful?

Tell us more

Select all that apply. More to say? Send a message to our writers.

Parameters are missing

API usage is not clear

The examples aren't helpful

Additional feedback?

Name Role Email Message** denotes a required field

Thanks, we appreciate your feedback!

If the information on this page is unclear, consider sending a message to our writers.

Thanks, we appreciate your feedback!

System settings

The system settings API enables you to retrieve values for system settings. Currently, this API supports retrieval of the geolocation setting.

Retrieve system settings

This API enables you to retrieve the value for the geolocation system setting.

Endpoint URL

https://DNS/api/version/systemSettings/settingKey

DNS - is the URL for your API service
version - is the API version
settingKey - The setting to retrieve a value for. Currently only api.search.geolocation.countries is supported.

Response
responseStatus: The status of the response.
configurationValue: The value for the system setting.
errors: An array of errors.

type - The error type.

message - A detailed message for the error type. This message is subject to change and is not contractual for error handling.

curl -X GET -H "Authorization: 57696C6C205261...6368204C6F7368" https://my.veevanetwork.com/api/v33.0/systemSettings/api.search.geolocation.countries

{
  "configurationValue":"US,FR",
  "responseStatus":"SUCCESS"
}

About entity types

Network uses the following entity or object types:

Level: Type
Top-level entity types: HCP, HCO, and custom objects (for example, TERRITORY__C, ROSTER_MEMBER__C, and so on)
Sub-object entity types: License, Address, Relationship (Parent HCOs), child objects (custom child objects)

About the vid_key

The vid_key is a unique identifier for any record that comes from the client application. This special key enables you to uniquely specify a record in Network by using any of the key identifiers that were used to build that record.

The vid_key format is composed of the following fields, separated by a colon:

custom_key_source_type__v - The source type specified when the data is loaded (for example, Network, VCRM, HDS, SHA, AMA).
custom_key_item_type__v - The type of item this key is for. This is used to discriminate between duplicate IDs that are meant for different objects. For example, a data source may have used tables with incrementing IDs for both addresses and license data, which means you could have two records with an ID of 1.
custom_key_value__v - The value of the key itself.

The vid_key for an HCP that was loaded from an existing Veeva CRM system could look like this, for example:

VCRM:HCP:001A000000pKagwIAC

Network supports the vid_key as long as it has the proper format.

For more efficient and faster processing, you should use the vid_key composed from Network when possible. The vid_key format for all the network entities is always as follows:

HCO or HCP entity key - Network:Entity:{vid__v}
Address key - Network:Address:{vid__v}
License key - Network:License:{vid__v}
Parent HCO key - Network:ParentHCO:{vid__v}

Custom objects

The vid_key for a custom object can be defined using the following methods:

using the custom key: {custom_key_source_type}:{custom_key_item_type__v}:{custom_key_value__v}, for example, vcrm:Publications__C:a29q0000002dr8y1AA
using the Network entity ID (VID): Network:Entity:919156929878115328

Finding the key

The fields that make up the vid_key are concatenated in a single field called custom_key_vid_key__v. This field appears many times when a search API call is made.

The correct one to use for HCPs and HCOs is:

entities --> entity --> custom_keys__v --> custom_key_vid_key__v

Errors

Every API call response includes a property called responseStatus. Possible values are:

SUCCESS - The request has been successfully processed.
FAILURE - The request could not be processed because of an API user error.
EXCEPTION - The request could not be processed because of an API system error.

For any status other than SUCCESS, API users can inspect the errors property called in the response for more information. This property lists any errors that occur while processing the request. For successful API calls, this property is omitted or has a null value.

The errors property includes the following information:

type - The error type; see below for a list of error types. API users will need to use this property in combination with the responseStatus property for error handling. The property values for responseStatus and type are contractual parts for error handling.
message - Detailed message for the error type. This message is subject to change and is not contractual for error handling.

{
   "networkId": 3,
   "sessionId": "1BDDF2B9DB53279C105B0D534B630FDAF68655D68EAA23B65C404FE96E607C44",
   "networkIds": [
      {
         "url": "https://my.network.com/api",
         "name": "Example Network",
         "id": 3
      }
   ],
   "responseStatus": "SUCCESS"
}

{
   "responseStatus": "FAILURE",
   "errors": [
      {
         "type": "NO_PASSWORD_PROVIDED",
         "message": "No password was provided for the login call."
      }
   ],
   "errorType": "AUTHENTICATION_FAILED"
}

Error types

Error: Description
400 - Bad Request
ATTRIBUTE_NOT_SUPPORTED: The specified resource does not recognize the attributes provided.
CANNOT_ACCESS_INSTANCE: The system name is invalid.
COUNTRY_NOT_ALLOWED: The API user does not have permissions to use records from the submitted country.
COUNTRY_NOT_RECOGNIZED: The submitted country is not recognized. Ensure that you use Network codes when sending country information.
DUPLICATE_KEY: A change request has been submitted with the same external identifier (change_request_key) that has already previously been submitted.
INVALID_DATA: Invalid data was provided in the API call.
INVALID_FILTER: A non-existent filter was provided to match HCPs or HCOs.
INVALID_SYSTEM_NAME: There are no active instances in your domain.
IP_RANGE: The IP range is invalid for this user.
REQUIRED_FIELD_NOT_FOUND: A required value is missing.
NO_ACTIVE_INSTANCES: There are no active instances in your domain.
OPERATION_NOT_ALLOWED: Certain rules required for this operation have not been met.
PARAMETER_REQUIRED: Required parameters are missing from the API call.
SUBSCRIPTION_DISABLED: The subscription is disabled and cannot be run.
UNSUPPORTED_TYPE: The object type is not supported.
401 - Unauthorized
NO_PASSWORD_PROVIDED: No password was provided for the login call.
PASSWORD_CHANGE_REQUIRED: A password change is required.
USER_LOCKED_OUT: The user is locked out.
USERNAME_OR_PASSWORD_ INCORRECT: Authentication failed because an invalid user name or password was provided.
403 - Forbidden
INSUFFICIENT_ACCESS: The user does not have sufficient privileges to perform the action.
404 - Not Found
MALFORMED_URL: The specified resource cannot be found.
405 - Method Not Allowed
METHOD_NOT_SUPPORTED: The specified resources does not support the method (POST, PUT, GET, DELETE) or the API request is not supported by this version of the API.
454 - Session Not Found
INVALID_SESSION_ID: An invalid session ID was provided.
500 - Internal Server Error
SERVER_NOT_AVAILABLE: The server is not available.
SERVER_NOT_RESPONDING: The server accepted the request but is not responding.
UNEXPECTED_ERROR: General error; occurs when there is no specific error or an unidentified error.