Individual endpoints in the LUSID REST API have a state:

  • Early Access, denoted in square brackets in Swagger:
     

  • Production. The status is omitted from Swagger:
     

  • Deprecated, denoted in square brackets in Swagger:
     

 

Early Access*

Production

Deprecated

Product state

Functionally complete

Generally available

Not recommended and may be removed

Access

Opt-in

YES

YES

Documentation

Draft

YES

YES

SDKs

Under development

YES

N/A

Luminesce providers**

Under development

YES

N/A

API changes

Reserve right to make breaking changes with notice

No breaking changes

N/A

Service level agreements***

YES

YES

YES

* Some API endpoints are currently denoted 'Experimental' and 'Beta' in addition to 'Early Access'. All are in a non-production state.

** The state of Luminesce providers can be ascertained by querying the Sys.Registration provider, for example select Name, Lifecycle from Sys.Registration. Note that Stable is equivalent to Production.

*** SLAs apply only to paid accounts, not to trial accounts.

Early Access

An API endpoint in Early Access is new or enhanced functionality made available for clients to selectively "opt-in" to and use in both production and non-production environments. Early Access endpoints are supported by FINBOURNE Support and have documentation in draft. Breaking changes to the API may be made in exceptional circumstances, and clients will be notified in advance.

Production

An API endpoint in Production is supported by FINBOURNE Support and is fully documented. There will be no breaking changes to the API.

Deprecated

An API endpoint identified as Deprecated is no longer recommended and may be removed in the future. This is typically a rare event designed to improve the product based on customer feedback, or to increase performance. We work closely with customers to minimise disruption, communicating intentions and remedial action, and taking action where necessary to prevent further use. Only when a deprecated API is no longer used by clients is it removed.