Include the Accept-Encoding: gzip header to compress responses as a gzipped file. It can significantly reduce the bandwidth required for a response.
If specified, Zuora automatically compresses responses that contain over 1000 bytes of data, and the response contains a Content-Encoding header with the compression algorithm so that your client can decompress it.
An entity ID. If you have Zuora Multi-entity enabled and the OAuth token is valid for more than one entity, you must use this header to specify which entity to perform the operation in. If the OAuth token is only valid for a single entity, or you do not have Zuora Multi-entity enabled, you do not need to set this header.
A custom identifier for tracing the API call. If you set a value for this header, Zuora returns the same value in the response headers. This header enables you to associate your system process identifiers with Zuora API calls, to assist with troubleshooting in the event of an issue.
The value of this field must use the US-ASCII character set and must not include any of the following characters: colon (:), semicolon (;), double quote ("), and quote (').
- https://rest.zuora.comhttps://rest.zuora.com/v1/object/amendment/{id}
curl -i -X GET \
'https://rest.zuora.com/v1/object/amendment/{id}?fields=string' \
-H 'Accept-Encoding: string' \
-H 'Authorization: string' \
-H 'Content-Encoding: string' \
-H 'Zuora-Entity-Ids: string' \
-H 'Zuora-Track-Id: string'This header is returned if you specify the Accept-Encoding: gzip request header and the response contains over 1000 bytes of data.
Note that only the following MIME types support gzipped responses:
application/jsonapplication/xmltext/htmltext/csvtext/plain
The request limit quota for the time window closest to exhaustion. See rate limits for more information.
The number of requests remaining in the time window closest to quota exhaustion. See rate limits for more information.
The number of seconds until the quota resets for the time window closest to quota exhaustion. See rate limits for more information.
The Zuora internal identifier of the API call. You cannot control the value of this header.
Determines whether the subscription is automatically renewed, or whether it expires at the end of the term and needs to be manually renewed. Required: For amendment of type TermsAndConditions when changing the automatic renewal status of a subscription. Values: true, false
A unique alphanumeric string that identifies the amendment. Character limit: 50 Values: one of the following:
nullgenerates a value automatically- A string
The date when the amendment's changes become effective for billing purposes. Version notes: --
The user ID of the person who created the amendment. Character limit: 32 Values: automatically generated
The date when the amendment was created. Values: automatically generated
The length of the period for the current subscription term. This field can be updated when Status is Draft. Required: Only if the value of the Type field is set to TermsAndConditions and TermType is set to TERMED. This field is not required if TermType is set to EVERGREEN. Character limit: Values: a valid number
The period type for the current subscription term. Values:
Month(default)YearDayWeekNote:This field can be updated when Status is
Draft.This field is used with the CurrentTerm field to specify the current subscription term.
The date when the customer accepts the amendment's changes to the subscription.
This field is only required if Zuora is configured to require customer acceptance in Z-Billing and the subscription is currently in the Pending Acceptance status (the value of the Status field is currently PendingAcceptance).
A description of the amendment. Character limit: 500 Values: maximum 500 characters
The date when the amendment's changes take effective. This field validates that the amendment's changes are within valid ranges of products and product rate plans. Required: For the cancellation amendments. Optional for other types of amendments. Version notes: --
The name of the amendment. Character limit: 100 Values: a string of 100 characters or fewer
Specifies whether a termed subscription will remain termed or change to evergreen when it is renewed. Required: If TermType is Termed Values: RENEW_WITH_SPECIFIC_TERM (default), RENEW_TO_EVERGREEN
The term of renewal for the amended subscription. This field can be updated when Status is Draft. Required: Only if the value of the Type field is set to TermsAndConditions. Character limit: Values: a valid number
The period type for the subscription renewal term. This field can be updated when Status is Draft. Required: Only if the value of the Type field is set to TermsAndConditions. This field is used with the RenewalTerm field to specify the subscription renewal term. Values:
Month(default)YearDayWeek
The date when service is activated.
This field is only required if Zuora is configured to require service activation in Z-Billing and the subscription is currently in the Pending Activation status (the value of the Status field is currently PendingActivation).
The date when the UpdateProduct amendment takes effect. This field is only applicable if there is already a future-dated UpdateProduct amendment on the subscription. Required: Only for the UpdateProduct amendments if there is already a future-dated UpdateProduct amendment on the subscription. Version notes: --
The status of the amendment. Type: string (enum) Character limit: 17 Values: one of the following:
Draft(default, if left null)PendingActivationPendingAcceptanceCompleted
The ID of the subscription that the amendment changes. Character limit: 32 Values: a valid subscription ID
Indicates if the subscription isTERMED or EVERGREEN.
- A TERMED subscription has an expiration date, and must be manually renewed.
- An EVERGREEN subscription doesn't have an expiration date, and must be manually ended.
Required: Only when as part of an amendment of type TermsAndConditions to change the term type of a subscription. Type: string Character limit: 9 Values: TERMED, EVERGREEN
The type of amendment. Character limit: 18 Values: one of the following:
- Cancellation
- NewProduct
- OwnerTransfer
- RemoveProduct
- Renewal
- UpdateProduct
- TermsAndConditions
- SuspendSubscription
- ResumeSubscription
The ID of the user who last updated the amendment. Character limit: 32 Values: automatically generated
The date when the amendment was last updated. Values: automatically generated
Custom fields of the Amendment object. The name of each custom field has the form customField__c. Custom field names are case sensitive. See Manage Custom Fields for more information.
{ "RenewalSetting": "RENEW_WITH_SPECIFIC_TERM", "Id": "2c93808457d787030157e02e430c1f15", "UpdatedDate": "2016-10-20T05:41:50.000+02:00", "SubscriptionId": "2c93808457d787030157e02e3ef61f02", "ServiceActivationDate": "2016-10-20", "CurrentTermPeriodType": "Month", "Description": "AMtssl1bnuq1", "ContractEffectiveDate": "2016-10-20", "CreatedById": "2c93808457d787030157e02e0bcf1d0c", "CreatedDate": "2016-10-20T05:41:50.000+02:00", "Name": "AMtssl1bnuq1_new", "CustomerAcceptanceDate": "2016-10-20", "Code": "A-AM00000004", "RenewalTermPeriodType": "Month", "Type": "NewProduct", "Status": "Draft", "UpdatedById": "2c93808457d787030157e02e0bcf1d0c", "EffectiveDate": "2016-10-20" }