Get all partner contacts

get

/crmRestApi/resources/11.13.18.05/partners/{CompanyNumber}/child/contacts

Request

Path Parameters
Query Parameters
  • This parameter specifies dependencies which are fields that are set before and rolled back after generating the response. Generally they are used to preview the effects of an attribute change. The fields specified in this parameter are always set in the resource instance in question. When a child resource collection is requested and the parameter is set, the fields will be set in the parent resource instance before generating the resource collection payload. The value of this query parameter is a set of dependency fields. Example: dependency=ProductId=2

    Format: <attr1>=<val1>,<attr2>=<value2>
  • When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
  • This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.

    Format: ?fields=Attribute1,Attribute2

    Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2
  • Used as a predefined finder to search the collection.

    Format: ?finder=<finderName>;<variableName>=<variableValue>,<variableName2>=<variableValue2>

    The following are the available finder names and corresponding finder variables:

    • CompanyNumberAndContactPartyNumberRF: Finds a partner contact by partner company number and party number.
      Finder Variables:
      • PartnerCompanyNumber; string; The unique identifier of the partner company.
      • PartyNumber; string; The unique identifier for the partner contact party. Can be system-generated or user-provided during create, based on the profile option HZ_GENERATE_PARTY_NUMBER.
    • CompanyNumberAndPartyNumberAltKey: Finds a partner contact by the company number or the party number.
      Finder Variables:
      • PartnerCompanyNumber; string.
    • ContactPartyNumberRF: Finds a partner contact by the party number.
      Finder Variables:
      • PartyNumber; string; The unique primary public identifier for the partner contact party.
    • PartyNumberAltKey: Finds a partner contact by the party number.
      Finder Variables:
      • PrimaryKey: Finds a partner contact by the party number.
        Finder Variables:
        • PartyId; integer; The ID field associated with a Partner Contact
      • SourceSystemReferenceAltKey: Finds a partner contact by source system reference value.
        Finder Variables:
        • SourceSystem; string; The name of the external source system of the partner contact.
        • SourceSystemReferenceValue; string; The identifier of the partner contact record from external source system.
      • SourceSystemReferenceRF: Finds a partner contact by source system and source system reference value.
        Finder Variables:
        • BindSourceSystem; string; The name of the external source system of the partner contact.
        • BindSourceSystemReferenceValue; string; The identifier of the partner contact record from external source system.
        • BindSystemDate; string; This is an internal attribute and should not be used.
    • This parameter restricts the number of resources returned inside the resource collection. If the limit exceeds the resource count then the framework will only return the available resources.
    • This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>

      Example:
      self,canonical
    • Used to define the starting position of the resource collection. If offset exceeds the resource count then no resources are returned. Default value is 0.
    • The resource item payload will be filtered in order to contain only data (no links section, for example).
    • This parameter orders a resource collection based on the specified fields. The parameter value is a comma-separated string of attribute names, each optionally followed by a colon and "asc" or "desc". Specify "asc" for ascending and "desc" for descending. The default value is "asc". For example, ?orderBy=field1:asc,field2:desc
    • This query parameter defines the where clause. The resource collection will be queried using the provided expressions. The value of this query parameter is one or more expressions. Example: ?q=Deptno>=10 and <= 30;Loc!=NY

      Format: ?q=expression1;expression2

      You can use these queryable attributes to filter this collection resource using the q query parameter:
      • AcademicTitle; string; The part of the person???s title that denotes the academic qualification, such as Dr. Jane Smith.
      • AddrElementAttribute1; string; An additional address element to support flexible address format.
      • AddrElementAttribute2; string; An additional address element to support flexible address format.
      • AddrElementAttribute3; string; An additional address element to support flexible address format.
      • AddrElementAttribute4; string; An additional address element to support flexible address format.
      • AddrElementAttribute5; string; An additional address element to support flexible address format.
      • AddressLineFour; string; The fourth line for address of the contact.
      • AddressLineOne; string; The first line for address.
      • AddressLineThree; string; The third line for address.
      • AddressLineTwo; string; The second line for address.
      • Building; string; The building name or number in the address of the contact.
      • CertificationLevel; string; The certification level of a contact. A list of accepted values is defined in the lookup HZ_PARTY_CERT_LEVEL. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
      • CertificationReasonCode; string; The code indicating the reason for the contact's current certification level assignment. A list of accepted values is defined using the lookup HZ_PARTY_CERT_REASON. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
      • City; string; The city element of the address.
      • Comments; string; The textual comments about a contact.
      • ContactName; string; The derived name of the contact.
      • Country; string; The country code of the address. Review the list of country codes using the Manage Geographies task.
      • CountryName; string; The name for the country of the partner company.
      • County; string; The county of the address.
      • CreateUserAccountFlag; boolean; Indicates whether the user account should be created. This should not be used currently.
      • CreatedBy; string; The user who created the record.
      • CreationDate; string; The date and time the record was created.
      • DateOfBirth; string; The date when the person was born.
      • DateOfDeath; string; The date when the person died.
      • DeceasedFlag; boolean; Indicates whether the person is deceased or not. If the value is True, then the person is deceased. The default value is False.
      • DeclaredEthnicity; string; The declared ethnicity of the person.
      • Department; string; The free form text used to name the department for the contact.
      • DepartmentCode; string; The code indicating the department of the contact. A list of accepted values is defined in the lookup DEPARTMENT_TYPE. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Contact Lookups task.
      • DoNotCallFlag; boolean; Indicates if the user can call the person or not. If the value is True, then the user must not call the person. The default value is False. A list of accepted values is defined using the lookup YES_NO. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Common Lookups task.
      • DoNotContactFlag; boolean; Indicates if the user can contact the person by phone, Email, or snail mail. If the value is True, then the user must not contact the person. The default value is False. A list of accepted values is defined using the lookup YES_NO. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Common Lookups task.
      • DoNotEmailFlag; boolean; Indicates if the user can email the person or not. If the value is True, then the user must not contact the person by email. The default value is False. A list of accepted values is defined using the lookup YES_NO. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Common Lookups task.
      • DoNotMailFlag; boolean; Indicates if the user can send mail to the person or not. If the value is True, then the user must not contact the person by mail. The default value is False. A list of accepted values is defined using the lookup YES_NO. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Common Lookups task.
      • EmailAddress; string; The e-mail address of the partner contact.
      • FavoriteContactFlag; boolean; Indicates whether the person is a key contact. If the value is True, then person is a key contact. The default value is False. You can't use this attribute as a finder, because this is a transient field. The response will return an error if you use this attribute as a finder.
      • FirstName; string; The first name of the person.
      • FloorNumber; string; The floor number of the address.
      • Gender; string; The gender of the person, such as male, female, and unknown. A list of accepted values is defined in the lookup HZ_GENDER. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Standard Lookups task.
      • Initials; string; The initials of the contact???s name.
      • JobTitle; string; The job title of the primary contact.
      • JobTitleCode; string; The code indicating the job title.
      • LastName; string; The last name of the person.
      • LastNamePrefix; string; The prefix for the last name of a person, such as De, Van. For example, if a person???s name is Hans De Vries, then the last name prefix De is captured using this attribute.
      • LastUpdateDate; string; The date on which the record was last updated.
      • LastUpdateLogin; string; The login details of the user who last updated the record.
      • LastUpdatedBy; string; The user who last updated the record.
      • Latitude; number; The latitude information for the address of the contact. The latitude information for the location is used for spatial proximity and containment purposes.
      • Longitude; number; The longitude information for the address of the contact. The longitude information for the location is used for spatial proximity and containment purposes.
      • Mailstop; string; The user-defined code that indicates a mail drop point within the organization.
      • MaritalStatus; string; The marital status of the person. A list of accepted values is defined in the lookup MARITAL_STATUS. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Standard Lookups task.
      • MaritalStatusEffectiveDate; string; The date when the person's marital status was changed.
      • MiddleName; string; The middle name of the person.
      • MobileAreaCode; string; The area code for partner contact's mobile phone.
      • MobileCountryCode; string; The international country code for a partner contact???s mobile phone number, such as 33 for France.
      • MobileExtension; string; The additional number used after initial connection to an internal telephone system.
      • MobileNumber; string; The mobile phone number of partner contact formatted in the local format. The number should not include area code, country code, or extension.
      • NameSuffix; string; The place in a family structure. For example, in "Tom Jones III", the "III" is the suffix.
      • NamedFlag; boolean; Indicates whether a sales account is a named sales account. If the value is True, then the sales account is a named sales account. The default value is False.
      • PartnerCompanyNumber; string; The unique identifier of the partner company.
      • PartnerName; string; The name of the partner associated with the contact.
      • PartnerPartyId; integer; The unique identifier of the party associated with the partner.
      • PartyId; integer; The unique identifier of the partner contact party generated by the system during creation.
      • PartyNumber; string; The unique identifier for the partner contact party. Can be system-generated or user-provided during create, based on the profile option HZ_GENERATE_PARTY_NUMBER.
      • PersonPreNameAdjunct; string; The title or the salutary introduction for a contact, such as Mr., Herr, and so on.
      • PlaceOfBirth; string; The place where the person was born, such as city or country.
      • PostalCode; string; The postal code as defined by the formal countrywide postal system.
      • PostalPlus4Code; string; The four-digit extension to the United States Postal ZIP code for the address.
      • PreferredContactMethod; string; The preferred method to contact the person. A list of accepted values is defined in the lookup HZ_PREFERRED_CONTACT_METHOD. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Contact Point Lookups task.
      • PreferredFunctionalCurrency; string; The preferred currency of the contact. A list of accepted values is defined using the Setup and Maintenance work area, Manage Currencies task.
      • PreviousLastName; string; The previous last name or surname of the person.
      • PrimaryAddressId; integer; The unique identifier for the address that is generated internally during create. One of AddressId, AddressNumber or SourceSystem and SourceSystemReferenceValue keys is used to identify the address record during update.
      • PrimaryContactPartyId; integer; The party identifier of the primary contact of the partner.
      • Province; string; The province of the address.
      • RawMobileNumber; string; The raw mobile phone number in the contact point.
      • RawWorkPhoneNumber; string; The raw work phone number in the contact point.
      • RentOrOwnIndicator; string; Indicates if this contact owns or rents his or her residence. A list of valid values for rent, own, and lease is defined in the lookup OWN_RENT_IND. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Standard Lookups task.
      • RoleName; string; The name of the resource role for partner contact.
      • SalesAffinityCode; string; The code indicating the affinity of a contact to the deploying organization. A list of accepted values is defined in the lookup HZ_SLS_CNTCT_AFFINITY_CODE. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Contact Lookups task.
      • SalesBuyingRoleCode; string; The code indicating the role played by a contact in the buying process, for example, decision maker or supporting role. A list of accepted values is defined in the lookup HZ_SLS_CNTCT_BUY_ROLE_CODE. Review and update the values for this attribute using the Setup and Maintenance work area, Manage Contact Lookups task.
      • Salutation; string; The phrase used to address a contact party in any correspondence.
      • SecondLastName; string; The second last name for a person. A list of accepted values is defined in the lookup HZ_PERSON_PROFILES. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Standard Lookups task.
      • State; string; The state element of the address.
      • Title; string; A professional or family title, such as Don or The Right Honorable.
      • Type; string; The contact party type that defines whether the contact is a sales account, a prospect, a contact or any other user-defined party type. The default value is ZCA_CUSTOMER. A list of accepted values is defined in the lookup ZCA_CONTACT_TYPE. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Standard Lookups task.
      • UserAccountRequestStatus; string; Status and error description, if any, for create user account LDAP request.
      • Username; string; The user name of the account for the partner contact. This should not be used currently.
      • WorkPhoneAreaCode; string; The area code for the partner contact's work phone.
      • WorkPhoneCountryCode; string; The international country code for a partner contact???s work phone number, such as 33 for France.
      • WorkPhoneExtension; string; The additional number used after initial connection to an internal telephone system.
      • WorkPhoneNumber; string; The work phone number of a partner contact formatted in the local format without the area code, country code, or extension.
    • The resource collection representation will include the "estimated row count" when "?totalResults=true", otherwise the count is not included. The default value is "false".
    Header Parameters
    • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
    • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

    There's no request body for this operation.

    Back to Top

    Response

    Supported Media Types

    Default Response

    The following table describes the default response for this task.
    Headers
    • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
    • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
    Body ()
    Root Schema : partners-contacts
    Type: object
    Show Source
    Nested Schema : Items
    Type: array
    Title: Items
    The items in the collection.
    Show Source
    Nested Schema : partners-contacts-item-response
    Type: object
    Show Source
    • Title: Academic Title
      Maximum Length: 30
      The part of the person???s title that denotes the academic qualification, such as Dr. Jane Smith.
    • Title: Additional Address Element 1
      Maximum Length: 150
      An additional address element to support flexible address format.
    • Title: Additional Address Element 2
      Maximum Length: 150
      An additional address element to support flexible address format.
    • Title: Additional Address Element 3
      Maximum Length: 150
      An additional address element to support flexible address format.
    • Title: Additional Address Element 4
      Maximum Length: 150
      An additional address element to support flexible address format.
    • Title: Additional Address Element 5
      Maximum Length: 150
      An additional address element to support flexible address format.
    • Title: Address Line 4
      Maximum Length: 240
      The fourth line for address of the contact.
    • Title: Address Line 1
      Maximum Length: 240
      The first line for address.
    • Title: Address Line 3
      Maximum Length: 240
      The third line for address.
    • Title: Address Line 2
      Maximum Length: 240
      The second line for address.
    • Title: Address Type
      The lookup code for the type of address, such as billing address, shipping address etc.
    • Attachments
      Title: Attachments
      An attachments resource is used to view, create, modify or delete the partner's attachments.
    • Title: Building
      Maximum Length: 240
      The building name or number in the address of the contact.
    • Title: Certification Level
      Maximum Length: 30
      The certification level of a contact. A list of accepted values is defined in the lookup HZ_PARTY_CERT_LEVEL. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
    • Title: Certification Reason
      Maximum Length: 30
      The code indicating the reason for the contact's current certification level assignment. A list of accepted values is defined using the lookup HZ_PARTY_CERT_REASON. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
    • Title: City
      Maximum Length: 60
      The city element of the address.
    • Title: Comments
      Maximum Length: 2000
      The textual comments about a contact.
    • Title: Name
      Maximum Length: 450
      The derived name of the contact.
    • Title: Country
      Maximum Length: 2
      The country code of the address. Review the list of country codes using the Manage Geographies task.
    • Read Only: true
      The name for the country of the partner company.
    • Title: County
      Maximum Length: 60
      The county of the address.
    • Read Only: true
      Maximum Length: 64
      The user who created the record.
    • Indicates whether the user account should be created. This should not be used currently.
    • Read Only: true
      The date and time the record was created.
    • Title: Date of Birth
      The date when the person was born.
    • Title: Date of Death
      The date when the person died.
    • Title: Person Deceased
      Maximum Length: 1
      Indicates whether the person is deceased or not. If the value is True, then the person is deceased. The default value is False.
    • Title: Declared Ethnicity
      Maximum Length: 60
      The declared ethnicity of the person.
    • Title: Department
      Maximum Length: 60
      The free form text used to name the department for the contact.
    • Title: Department Code
      Maximum Length: 30
      The code indicating the department of the contact. A list of accepted values is defined in the lookup DEPARTMENT_TYPE. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Contact Lookups task.
    • Title: Do Not Call
      Maximum Length: 1
      Indicates if the user can call the person or not. If the value is True, then the user must not call the person. The default value is False. A list of accepted values is defined using the lookup YES_NO. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Common Lookups task.
    • Title: Do Not Contact
      Maximum Length: 1
      Indicates if the user can contact the person by phone, Email, or snail mail. If the value is True, then the user must not contact the person. The default value is False. A list of accepted values is defined using the lookup YES_NO. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Common Lookups task.
    • Title: Do Not Email
      Maximum Length: 1
      Indicates if the user can email the person or not. If the value is True, then the user must not contact the person by email. The default value is False. A list of accepted values is defined using the lookup YES_NO. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Common Lookups task.
    • Title: Do Not Mail
      Maximum Length: 1
      Indicates if the user can send mail to the person or not. If the value is True, then the user must not contact the person by mail. The default value is False. A list of accepted values is defined using the lookup YES_NO. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Common Lookups task.
    • Title: Email
      Maximum Length: 320
      The e-mail address of the partner contact.
    • Title: Favorite
      Maximum Length: 10
      Default Value: false
      Indicates whether the person is a key contact. If the value is True, then person is a key contact. The default value is False. You can't use this attribute as a finder, because this is a transient field. The response will return an error if you use this attribute as a finder.
    • Title: First Name
      Maximum Length: 150
      The first name of the person.
    • Title: Floor
      Maximum Length: 40
      The floor number of the address.
    • Title: Primary Address
      Read Only: true
      The formatted address of the partner contact.
    • Title: Phone Number
      Read Only: true
      The formatted mobile phone number information.
    • Title: Phone Number
      Read Only: true
      The formatted work phone number information.
    • Title: Gender
      Maximum Length: 30
      The gender of the person, such as male, female, and unknown. A list of accepted values is defined in the lookup HZ_GENDER. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Standard Lookups task.
    • Title: Head of Hierarchy
      Maximum Length: 255
      Indicates whether this partner contact is a root resource of Partner or not. The value 'Y' indicates that this partner contact is a root resource of the partner.
    • Title: Initials
      Maximum Length: 20
      The initials of the contact???s name.
    • Default Value: false
      Indicates whether an existing contact from an account would be converted to partner contact. The value 'Y' indicates that the party id of the existing account contact would be used for the partner contact if the related account is already a partner.
    • Title: Self-Registered
      Indicates whether the partner registration approval process will be invoked or not. If the value is Y, then the process will be invoked.
    • Title: Job Title
      Maximum Length: 100
      The job title of the primary contact.
    • Title: Job Title Code
      Maximum Length: 30
      The code indicating the job title.
    • Title: Last Name
      Maximum Length: 150
      The last name of the person.
    • Title: Last Name Prefix
      Maximum Length: 30
      The prefix for the last name of a person, such as De, Van. For example, if a person???s name is Hans De Vries, then the last name prefix De is captured using this attribute.
    • Read Only: true
      The date on which the record was last updated.
    • Read Only: true
      Maximum Length: 64
      The user who last updated the record.
    • Read Only: true
      Maximum Length: 32
      The login details of the user who last updated the record.
    • Title: Latitude
      The latitude information for the address of the contact. The latitude information for the location is used for spatial proximity and containment purposes.
    • Links
    • Title: Longitude
      The longitude information for the address of the contact. The longitude information for the location is used for spatial proximity and containment purposes.
    • Title: Mail Stop
      Maximum Length: 60
      The user-defined code that indicates a mail drop point within the organization.
    • Title: Manager
      Read Only: true
      Maximum Length: 255
      The name of the manager of partner contact.
    • Title: Manager
      The unique identifier of the manager party of the partner contact.
    • Maximum Length: 30
      The party number of the manager of the partner contact.
    • Title: Marital Status
      Maximum Length: 30
      The marital status of the person. A list of accepted values is defined in the lookup MARITAL_STATUS. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Standard Lookups task.
    • Title: Marital Status Effective Date
      The date when the person's marital status was changed.
    • Title: Middle Name
      Maximum Length: 60
      The middle name of the person.
    • Title: Area Code
      Maximum Length: 20
      The area code for partner contact's mobile phone.
    • Title: Phone Country Code
      Maximum Length: 10
      The international country code for a partner contact???s mobile phone number, such as 33 for France.
    • Title: Extension
      Maximum Length: 20
      The additional number used after initial connection to an internal telephone system.
    • Title: Phone
      Maximum Length: 40
      The mobile phone number of partner contact formatted in the local format. The number should not include area code, country code, or extension.
    • Title: Named Contact
      Maximum Length: 1
      Default Value: false
      Indicates whether a sales account is a named sales account. If the value is True, then the sales account is a named sales account. The default value is False.
    • Title: Suffix
      Maximum Length: 30
      The place in a family structure. For example, in "Tom Jones III", the "III" is the suffix.
    • Title: Partner Number
      Maximum Length: 30
      The unique identifier of the partner company.
    • Title: Name
      Read Only: true
      Maximum Length: 360
      The name of the partner associated with the contact.
    • The unique identifier of the party associated with the partner.
    • The unique identifier of the partner contact party generated by the system during creation.
    • Title: Registry ID
      Maximum Length: 30
      The unique identifier for the partner contact party. Can be system-generated or user-provided during create, based on the profile option HZ_GENERATE_PARTY_NUMBER.
    • Title: Prefix
      Maximum Length: 30
      The title or the salutary introduction for a contact, such as Mr., Herr, and so on.
    • Title: Place of Birth
      Maximum Length: 60
      The place where the person was born, such as city or country.
    • Title: Postal Code
      Maximum Length: 60
      The postal code as defined by the formal countrywide postal system.
    • Title: Postal Code Extension
      Maximum Length: 20
      The four-digit extension to the United States Postal ZIP code for the address.
    • Title: Preferred Contact Method
      Maximum Length: 30
      The preferred method to contact the person. A list of accepted values is defined in the lookup HZ_PREFERRED_CONTACT_METHOD. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Contact Point Lookups task.
    • Title: Preferred Functional Currency
      Maximum Length: 15
      The preferred currency of the contact. A list of accepted values is defined using the Setup and Maintenance work area, Manage Currencies task.
    • Title: Previous Last Name
      Maximum Length: 150
      The previous last name or surname of the person.
    • The unique identifier for the address that is generated internally during create. One of AddressId, AddressNumber or SourceSystem and SourceSystemReferenceValue keys is used to identify the address record during update.
    • Read Only: true
      The party identifier of the primary contact of the partner.
    • Title: Primary Contact Indicator
      Maximum Length: 255
      Indicates whether this partner contact is primary contact of partner or not. If the value is True, then this partner contact is a primary contact.
    • Title: Province
      Maximum Length: 60
      The province of the address.
    • Title: Phone
      Maximum Length: 60
      The raw mobile phone number in the contact point.
    • Title: Phone
      Maximum Length: 60
      The raw work phone number in the contact point.
    • Title: Rent or Own Indicator
      Maximum Length: 30
      Indicates if this contact owns or rents his or her residence. A list of valid values for rent, own, and lease is defined in the lookup OWN_RENT_IND. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Standard Lookups task.
    • Maximum Length: 30
      The role code of the partner contact.
    • Title: Role
      The unique identifier of the resource role of the partner contact.
    • Title: Role
      Read Only: true
      Maximum Length: 255
      The name of the resource role for partner contact.
    • Title: Affinity
      Maximum Length: 30
      The code indicating the affinity of a contact to the deploying organization. A list of accepted values is defined in the lookup HZ_SLS_CNTCT_AFFINITY_CODE. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Contact Lookups task.
    • Title: Buying Role
      Maximum Length: 30
      The code indicating the role played by a contact in the buying process, for example, decision maker or supporting role. A list of accepted values is defined in the lookup HZ_SLS_CNTCT_BUY_ROLE_CODE. Review and update the values for this attribute using the Setup and Maintenance work area, Manage Contact Lookups task.
    • Title: Salutation
      Maximum Length: 60
      The phrase used to address a contact party in any correspondence.
    • Title: Second Last Name
      Maximum Length: 150
      The second last name for a person. A list of accepted values is defined in the lookup HZ_PERSON_PROFILES. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Standard Lookups task.
    • The name of the external source system.
    • The identifier of the record from external source system.
    • Title: State
      Maximum Length: 60
      The state element of the address.
    • Title: Title
      Maximum Length: 60
      A professional or family title, such as Don or The Right Honorable.
    • Title: Type
      Maximum Length: 30
      The contact party type that defines whether the contact is a sales account, a prospect, a contact or any other user-defined party type. The default value is ZCA_CUSTOMER. A list of accepted values is defined in the lookup ZCA_CONTACT_TYPE. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Standard Lookups task.
    • Read Only: true
      Indicates whether the partner contact object can be updated by the current user or not. If the value is True, then the partner contact object can be updated.
    • Title: User Account Request Status
      Read Only: true
      Status and error description, if any, for create user account LDAP request.
    • User Account Details
      Title: User Account Details
      The user account details resource is used to view, create, update, and delete the user account details of a partner contact.
    • The user name of the account for the partner contact. This should not be used currently.
    • Title: Area Code
      Maximum Length: 20
      The area code for the partner contact's work phone.
    • Title: Phone Country Code
      Maximum Length: 10
      The international country code for a partner contact???s work phone number, such as 33 for France.
    • Title: Extension
      Maximum Length: 20
      The additional number used after initial connection to an internal telephone system.
    • Title: Phone
      Maximum Length: 40
      The work phone number of a partner contact formatted in the local format without the area code, country code, or extension.
    Nested Schema : Attachments
    Type: array
    Title: Attachments
    An attachments resource is used to view, create, modify or delete the partner's attachments.
    Show Source
    Nested Schema : User Account Details
    Type: array
    Title: User Account Details
    The user account details resource is used to view, create, update, and delete the user account details of a partner contact.
    Show Source
    Nested Schema : partners-contacts-attachments-item-response
    Type: object
    Show Source
    Nested Schema : partners-contacts-userdetails-item-response
    Type: object
    Show Source
    Back to Top

    Examples

    cURL Command

    The following example shows how to get all partner contacts by submitting get request on the REST resource using cURL.

    curl -u <username:password> \ -X GET https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/partners/{CompanyNumber}/child/contacts
    

    Example of Response Body

    The following example shows the contents of the response body in JSON format.

    {
     "OrganizationName":"Stry22.",
     "AddressLineOne":"2280 Quimby Road",
     "Country":"US",
    "contacts":[{
    "FirstName":"dd_pc_fn",
    "LastName":"dd_pc_ln",
    "EmailAddress":"u.m@a.com"
    }]} 
    
    Back to Top