...
Subscription registration and token generation – through the User interface (see the above section)
Sending a request for TMY data generation
In case of a correct request, “requestId” is returned
In case of there is some issue, an error code is returned
Sending a request for TMY data generation status
In case of successful and finished processing, URL with generated data link is retrieved
In case of request processing, processing status information is returned
In case of any issue, an error code is returned
There is one additional supporting endpoint exposed to supplement requestor with subscription details like such as user name (for in the case of using user tokens), company, and assigned subscriptions. If the authorization token that was used for subscription details retrieving is bound to a user, subscriptions details of the subscription to which the user is assigned are retrieved in the response message. Additionally, the response contains also information about the user assigned to the token.
...
TMY Subscription (displayed on the Company Subscription Overview page) can have one of the following states:
Active
Consumption is enabled – parameter set on the subscription
Subscription can be used from date point of view (valid from <= now <= valid to)
Subscription has remaining calls that can be consumed
Inactive
Consumption is disabled – parameter set on the subscription
Expired
Consumption is enabled – parameter set on the subscription
Subscription is not valid from a date point of view (valid to > now)
Consumed
Consumption is enabled – parameter set on the subscription
Subscription can be used from date point of view (valid from >= now <= valid to)
Subscription The subscription does not have any remaining calls that can be consumed
ToBeActive
Consumption is enabled – parameter set on the subscription
Subscription can be used in the future (valid from > now)
Subscription has remaining calls that can be consumed
...
HTTP status code 404
for example, the request cannot be found based on the provided requestId
...