Get a subscription account

get

/crmRestApi/resources/11.13.18.05/subscriptionAccounts/{SubscrAccountNumber}

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
  • 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
  • The resource item payload will be filtered in order to contain only data (no links section, for example).
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 : subscriptionAccounts-item-response
Type: object
Show Source
  • Title: Account Class
    Maximum Length: 30
    Default Value: ORA_ATC_ACCOUNT_OWNER
    Indicates the type of the subscription account. Possible values are OWNER_ACCOUNT, BILLING_ACCOUNT, CUST_ACCOUNT.
  • Title: Subscription Account Name
    Maximum Length: 240
    The description chosen by external party (but can be entered internally on behalf on the customer).
  • Title: Status
    Maximum Length: 30
    Default Value: A
    The status of the subscription account.
  • Title: Additional Address Element 1
    Maximum Length: 150
    The additional address element to support flexible address format.
  • Title: Additional Address Element 2
    Maximum Length: 150
    The additional address element to support flexible address format.
  • Title: Additional Address Element 3
    Maximum Length: 150
    The additional address element to support flexible address format.
  • Title: Additional Address Element 4
    Maximum Length: 150
    The additional address element to support flexible address format.
  • Title: Additional Address Element 5
    Maximum Length: 150
    The additional address element to support flexible address format.
  • Title: Address Line 1
    Maximum Length: 240
    The first line of the account address.
  • Title: Address Line 2
    Maximum Length: 240
    The second line of the account address.
  • Title: Address Line 3
    Maximum Length: 240
    The third line of the account address.
  • Title: Address Line 4
    Maximum Length: 240
    The fourth line of the account address.
  • Title: Address Lines Phonetic
    Maximum Length: 560
    The phonetic or Kana representation of the Kanji address lines (used in Japan).
  • Title: Address Number
    Maximum Length: 30
    The address number associated with the subscription account.
  • Title: Address Type
    Maximum Length: 100
    Address Type is the static choice list with values indicating the type of address.
  • Attachments
    Title: Attachments
    The attachments resource is used to view, create, update, and delete an attachment. The attachments are associated with the subscription account.
  • Billing Profiles
    Title: Billing Profiles
    The billing profiles resource is used view, create, update, and delete a billing profile. It lists all the billing profiles for the given subscription account.
  • Title: Building
    Maximum Length: 240
    The specific building name or number of a given address.
  • Title: City
    Maximum Length: 60
    The city of the identifying address.
  • Title: Common Business Identifier
    Maximum Length: 265
    The primary identifier assigned to businesses by government agency, Chamber of Commerce, or other authority, generally used outside US.
  • Title: Corporate Currency Code
    Maximum Length: 15
    The corporate currency code associated with the subscription account. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the profile option using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Corporation Class
    Maximum Length: 30
    The taxation classification for corporation entities such as Chapter S in the US.
  • Title: Country
    Maximum Length: 2
    The country of the identifying address.
  • Title: County
    Maximum Length: 60
    The county of the identifying address.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created the row.
  • Title: Creation Date
    Read Only: true
    The date when the record was created.
  • Title: Credit Agency
    Maximum Length: 30
    The credit agency for subscription account.
  • Title: Credit Score
    Minimum Value: 0
    The credit score issues by the credit agency for the subscription account.
  • Title: Credit Threshold
    Minimum Value: 0
    The credit threshold for subscription account issued by the credit agency.
  • Title: Credit Update Date
    The credit update date for subscription account.
  • Title: Credit Updated By
    Maximum Length: 30
    The use who updated the credit information for the subscription account.
  • Title: Currency Conversion Rate Type
    Maximum Length: 30
    The currency conversion rate type. A list of valid values are defined in the lookup ZCA_COMMON_RATE_TYPE. Review and update the profile option using the Setup and Maintenance work area, Manage Currency Profile Options task.
  • Title: Currency Code
    Maximum Length: 15
    The rate of currency conversion for a subscription account.
  • Title: Customer Account ID
    The unique identifier of the customer account. The foreign key to the HZ_CUST_ACCOUNTS table.
  • Read Only: true
    The unique identifier of the customer account side.
  • Title: Daily Threshold
    Minimum Value: 0
    The daily threshold limit for subscription account.
  • Title: D&B Credit Rating
    Maximum Length: 30
    The Dun & Bradstreet credit rating.
  • Read Only: true
    Indicates whether the subscription account has been deleted.
  • Title: Directory Assistance Start Date
    The date when directory assistance starts for the subscription account.
  • Title: Directory Assistance Status
    Maximum Length: 30
    The status of directory assistance for the subscription account.
  • Title: Domestic Threshold
    Minimum Value: 0
    The domestic threshold for subscription accounts.
  • Title: D-U-N-S Number
    Maximum Length: 30
    The column value not restricted to nine digit DUNS Number.
  • Title: Duplicate Type
    Maximum Length: 30
    The duplicate status of the record. A null value indicates that either the record is not a duplicate or it has not been evaluated. DUPE indicates the record is duplicate. LINK indicates that the record is linked to another record.
  • Title: Floor
    Maximum Length: 40
    The specific floor number at a given address or in a particular building when the building number is provided.
  • Title: Address
    Read Only: true
    Maximum Length: 255
    The formatted address of the identifying address.
  • Title: Address
    Read Only: true
    The formatted multiline address of the identifying address.
  • Title: International Threshold
    Minimum Value: 0
    The international threshold for the subscription account.
  • Title: Last Source Update Date
    The timestamp when this record was updated by the source system in the last update source system column.
  • Title: Last Updated Date
    Read Only: true
    The date when the record was last updated.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The user who last updated the record.
  • Title: Last Update Login
    Read Only: true
    Maximum Length: 32
    The login of the user who last updated the record.
  • Title: Last Update Source System
    Maximum Length: 30
    The source system that last updated this record.
  • Title: Legal Entity ID
    The legal entity associated with the subscription account.
  • Links
  • Title: Location ID
    Read Only: true
    The unique identifier of the subscription account primary address.
  • Title: Maximum Call Duration
    Minimum Value: 0
    The maximum call duration for subscription account.
  • Title: Maximum Calls
    Minimum Value: 0
    The maximum number of calls for subscription account.
  • Title: Maximum Call Cost
    Minimum Value: 0
    The maximum cost that is set for the subscription account.
  • Title: Nonprofit Organization
    Maximum Length: 1
    Indicates whether the organization is a non-profit organization. Y for non-profit organization and N for profit organization.
  • Notes
    Title: Notes
    The notes resource is used to view, create, update, and delete notes associated with the subscription account. A note captures comments, information, or instructions related to an account.
  • Title: Parent Subscription Account ID
    The unique identifier of the parent subscription account. It specifies the parent account of the subscription account.
  • Title: Subscription Account Number
    Maximum Length: 30
    The unique user key for the Parent Subscription Account Object.
  • Title: Parent Subscription Account Name
    Read Only: true
    Maximum Length: 240
    The name of the Parent Subscription Account.
  • Title: Party ID
    The uniquely generated id for HZ_PARTY.
  • Title: Name
    Read Only: true
    Maximum Length: 360
    The name of the party.
  • Title: Registry ID
    Maximum Length: 30
    This is a unique user key for the table.
  • Read Only: true
    The unique identifier of the party site of the identifying address.
  • Title: Party Type
    Read Only: true
    Maximum Length: 30
    The party type, like consumer or organization.
  • Title: Percentage Overflow
    Minimum Value: 0
    The percentage overflow for subscription account.
  • Title: Phone Assistance Exemption
    Maximum Length: 1
    Default Value: false
    The phone assistance exemption for subscription account.
  • Title: Phone Assistance Renewal Date
    The phone assistance renewal date for the subscription account.
  • Title: Phone Assistance Request Date
    The date when the phone assistance request for the subscription account was made.
  • Title: Phone Assistance Start Date
    The date when the phone assistance for the subscription account starts.
  • Title: Postal Code
    Maximum Length: 60
    The postal code of the subscription account primary address.
  • Title: Postal Code Extension
    Maximum Length: 20
    The four digit extension to the United States Postal ZIP code.
  • Title: Primary Language
    Maximum Length: 30
    The primary language for subscription account.
  • Title: Privately Owned
    Maximum Length: 1
    Indicates whether the organization is privately owned. Y for a privately owned organization, N for a publicly owned organization.
  • Title: Province
    Maximum Length: 60
    The province of the identifying address.
  • Title: Registration Type
    Maximum Length: 30
    The lookup for type of registration, such as nonprofit.
  • Title: Sales Account ID
    Read Only: true
    The party identifier for Organization.
  • Title: Sensitive Number Threshold
    Minimum Value: 0
    The sensitive number threshold for the subscription account.
  • Read Only: true
    The reference set of the record.
  • Read Only: true
    The account site set of the identifying address.
  • Read Only: true
    The site use code of the identifying address.
  • Title: Small Business
    Maximum Length: 1
    Indicates the company is considered to be a small business. Y for small businesses, N for all other firms.
  • Title: Source System
    Maximum Length: 30
    The source system of the record.
  • Title: Source System Reference
    Maximum Length: 255
    The reference of the source system.
  • Title: State
    Maximum Length: 60
    The state of the identifying address.
  • Title: State Seller Tax Permit or License Number
    Maximum Length: 30
    The state sell tax permit LIC number for subscription account.
  • Title: Subscription Account Number
    Maximum Length: 30
    The alternate unique identifier of the subscription account.
  • Subscription Account Addresses
    Title: Subscription Account Addresses
    The subscription account addresses resource is used to view, create, update, and delete an account resource. It lists all the subscription account addresses with details.
  • Subscription Account Asset Relationships
    Title: Subscription Account Asset Relationships
    The subscription account asset relationships resource is used to view, create, update, and delete a subscription account asset relationship. It lists all the subscription account asset relationships with details.
  • Title: Subscription Account ID
    Read Only: true
    The unique identifier of the subscription account.
  • Subscription Account Relationships
    Title: Subscription Account Relationships
    The subscription account relationships resource is used to view, create, update, and delete an account relationship.
  • Subscription Account Roles
    Title: Subscription Account Roles
    The subscription account roles resource is used to view, create, update, and delete an account role. It lists all the subscription account roles with details.
  • Title: Tax Code
    Read Only: true
    Maximum Length: 50
    The tax code for the customer.
  • Title: Tax Identification Number
    Maximum Length: 30
    The tax payer identification number, often unique identifier of person or organization, such as SSN , income taxpayer ID in US, or fiscal code or NIF in Europe.
  • Read Only: true
    Indicates whether the subscription account has been updated.
Nested Schema : Attachments
Type: array
Title: Attachments
The attachments resource is used to view, create, update, and delete an attachment. The attachments are associated with the subscription account.
Show Source
Nested Schema : Billing Profiles
Type: array
Title: Billing Profiles
The billing profiles resource is used view, create, update, and delete a billing profile. It lists all the billing profiles for the given subscription account.
Show Source
Nested Schema : Notes
Type: array
Title: Notes
The notes resource is used to view, create, update, and delete notes associated with the subscription account. A note captures comments, information, or instructions related to an account.
Show Source
Nested Schema : Subscription Account Addresses
Type: array
Title: Subscription Account Addresses
The subscription account addresses resource is used to view, create, update, and delete an account resource. It lists all the subscription account addresses with details.
Show Source
Nested Schema : Subscription Account Asset Relationships
Type: array
Title: Subscription Account Asset Relationships
The subscription account asset relationships resource is used to view, create, update, and delete a subscription account asset relationship. It lists all the subscription account asset relationships with details.
Show Source
Nested Schema : Subscription Account Relationships
Type: array
Title: Subscription Account Relationships
The subscription account relationships resource is used to view, create, update, and delete an account relationship.
Show Source
Nested Schema : Subscription Account Roles
Type: array
Title: Subscription Account Roles
The subscription account roles resource is used to view, create, update, and delete an account role. It lists all the subscription account roles with details.
Show Source
Nested Schema : subscriptionAccounts-Attachments-item-response
Type: object
Show Source
Nested Schema : subscriptionAccounts-billingProfiles-item-response
Type: object
Show Source
Nested Schema : subscriptionAccounts-Note-item-response
Type: object
Show Source
Nested Schema : subscriptionAccounts-subscriptionAccountAddress-item-response
Type: object
Show Source
Nested Schema : subscriptionAccounts-subscriptionAccountAssetRelationships-item-response
Type: object
Show Source
Nested Schema : subscriptionAccounts-subscriptionAccountRelationship-item-response
Type: object
Show Source
Nested Schema : subscriptionAccounts-subscriptionAccountRoles-item-response
Type: object
Show Source
Back to Top