masstack

V1
V1-rfm
V2
V3-sales
API Overview Resources Schemas

Contracts

Contract documents associated with subscriptions or bundles

Parameters

Name In Type Required Description
org path string true Organization name
subscriptionId path string(uuid) true Subscription unique identifier
contractId path string(uuid) true Contract unique identifier

Request example

1
2
3
4
5


curl -X GET https://subscriptions.masstack.com/v2/orgs/yoigo/subscriptions/ce2f20cb-35df-4ffe-bca6-c0ed0c28cb39/contracts/a570614e-8a66-4d93-b329-7a2c9d6f0ce8 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Responses

Code Meaning Description Schema
200 OK Contract found Contract
403 Forbidden Forbidden access ErrorResponse
404 Not Found Contract not found ErrorResponse
500 Internal Server Error Internal server error ErrorResponse
default Default Any client or server error ErrorResponse

Parameters

Name In Type Required Description
org path string true Organization name
subscriptionId path string(uuid) true Subscription unique identifier
offset query integer false Pagination offset
limit query integer false Pagination limit

Request example

1
2
3
4
5


curl -X GET https://subscriptions.masstack.com/v2/orgs/yoigo/subscriptions/ce2f20cb-35df-4ffe-bca6-c0ed0c28cb39/contracts?offset='0'&limit='50' \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Responses

Code Meaning Description Schema
200 OK Contracts found for the subscription ContractsSet
403 Forbidden Forbidden access ErrorResponse
404 Not Found A subscription with the specified id was not found ErrorResponse
500 Internal Server Error Internal server error ErrorResponse
default Default Any client or server error ErrorResponse

Parameters

Name In Type Required Description
org path string true Organization name
subscriptionId path string(uuid) true Subscription unique identifier
body body Contract true Contract data

Request body - instance of Contract

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
  "id": "ce2f20cb-35df-4ffe-bca6-c0ed0c28cb39",
  "documents_contract_id": "12345678-1234-1234-1234-123456789012",
  "documents_owner_id": "87654321-4321-4321-4321-210987654321",
  "creation_date": "2025-01-05T03:30:15Z",
  "creation_user": "john.doe@masorange.es",
  "creation_system": "mas-subscriptions.auth.masmovil.com",
  "last_updated_date": "2025-01-06T10:30:15Z",
  "last_updated_user": "jane.smith@masorange.es"
}
Name Type Required Description
id string(uuid) true Contract id
documents_contract_id string true Documents service contract id
documents_owner_id string true Documents service owner id
creation_date string(date-time) false Creation date according to ISO 8601
creation_user string false User who created the contract
creation_system string false System that created the contract
last_updated_date string(date-time) false Last update date according to ISO 8601
last_updated_user string false User who last updated the contract

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


curl -X POST https://subscriptions.masstack.com/v2/orgs/yoigo/subscriptions/ce2f20cb-35df-4ffe-bca6-c0ed0c28cb39/contracts \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}" \
 --data-raw "{
  'documents_contract_id': '12345678-1234-1234-1234-123456789012',
  'documents_owner_id': '87654321-4321-4321-4321-210987654321'
}"

Responses

Code Meaning Description Schema
201 Created Contract successfully added Contract
400 Bad Request Bad request ErrorResponse
403 Forbidden Forbidden access ErrorResponse
404 Not Found A subscription with the specified id was not found ErrorResponse
500 Internal Server Error Internal server error ErrorResponse
default Default Any client or server error ErrorResponse

Parameters

Name In Type Required Description
org path string true Organization name
subscriptionId path string(uuid) true Subscription unique identifier
contractId path string(uuid) true Contract unique identifier

Request example

1
2
3
4
5


curl -X GET https://subscriptions.masstack.com/v2/orgs/yoigo/subscriptions/ce2f20cb-35df-4ffe-bca6-c0ed0c28cb39/contracts/a570614e-8a66-4d93-b329-7a2c9d6f0ce8/documents \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Responses

Code Meaning Description Schema
200 OK Contract documents found ContractDocumentsSet
403 Forbidden Forbidden access ErrorResponse
404 Not Found A subscription with the specified id was not found ErrorResponse
500 Internal Server Error Internal server error ErrorResponse
default Default Any client or server error ErrorResponse

Endpoints

Subscriptions

    Bundles

      Promotions

        Devices

          AddOns

            Amazon Prime

              Max

                Mobile

                  Broadband

                    Landline

                      Orange TV

                        Orange TV Libre

                          Disney

                            AgileTv

                              Netflix

                                Credit Limits

                                  Change Requests

                                    Commitments

                                      DeviceInsurance

                                        Multisim

                                          Payment Plans

                                            Operations

                                              Contracts