How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Matters API

The Matters API exposes endpoints to create, update and retrieve a matter. Batching of matter requests is also supported through the $batch endpoint.

Matters API is one of 324 APIs that Thomson Reuters publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Legal and Legal Tracker. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 47 operations across 44 paths, and defines 68 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 12 base URLs: https://api.thomsonreuters.com/legal-tracker/datawarehouse-api/odata/v1, https://api.thomsonreuters.com.au/legal-tracker/datawarehouse-api/odata/v1, https://api.thomsonreuters.co.uk/legal-tracker/datawarehouse-api/odata/v1, https://api.thomsonreuters.ca/legal-tracker/datawarehouse-api/odata/v1, https://api.thomsonreuters.de/legal-tracker/datawarehouse-api/odata/v1, https://api.thomsonreuters.ae/legal-tracker/datawarehouse-api/odata/v1, https://api.thomsonreuters.com/legal-tracker/matters-api/v1, https://api.thomsonreuters.co.uk/legal-tracker/matters-api/v1, https://api.thomsonreuters.ca/legal-tracker/matters-api/v1, https://api.thomsonreuters.com.au/legal-tracker/matters-api/v1, https://api.thomsonreuters.de/legal-tracker/matters-api/v1, https://api.thomsonreuters.ae/legal-tracker/matters-api/v1.

47 operations 44 paths 68 schemas 44 GET2 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://api.thomsonreuters.com/legal-tracker/matters-api/v1
Authentication
OAuth 2.0, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Matters API declares 2 security schemes for authenticating requests. It supports OAuth 2.0 (OAuth2) using the clientCredentials flow, exposing 1 scope. It accepts HTTP bearer tokens (Token).

  • Token — Access token (TR Account)

Paths & Operations 47

Across 44 paths, the API surfaces 47 operations — 44 GET, 2 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Matters 47
GET
/Matters
Get entities from Matters
getMatters 6 params → 2004XX
GET
/Matters('{MatterId}')
Get entity from Matters by key
getMatters('{MatterId}') 1 param → 2004XX
GET
/Matters('{MatterId}')/BilledToEntity
Get related BilledToEntity
getMatters('{MatterId}')BilledToEntity 1 param → 2004XX
GET
/Matters('{MatterId}')/APRoute
Get related APRoute
getMatters('{MatterId}')APRoute 1 param → 2004XX
GET
/Matters('{MatterId}')/Country
Get related Country
getMatters('{MatterId}')Country 1 param → 2004XX
GET
/Matters('{MatterId}')/MatterType
Get related MatterType
getMatters('{MatterId}')MatterType 1 param → 2004XX
GET
/Matters('{MatterId}')/PracticeGroup
Get related PracticeGroup
getMatters('{MatterId}')PracticeGroup 1 param → 2004XX
GET
/Matters('{MatterId}')/OrgUnit
Get related OrgUnit
getMatters('{MatterId}')OrgUnit 1 param → 2004XX
GET
/Matters('{MatterId}')/SubstantiveLaw
Get related SubstantiveLaw
getMatters('{MatterId}')SubstantiveLaw 1 param → 2004XX
GET
/Matters('{MatterId}')/MatterCustomTreeNodeField
Get related MatterCustomTreeNodeField
getMatters('{MatterId}')MatterCustomTreeNodeField 1 param → 2004XX
GET
/Matters('{MatterId}')/MatterCustomCurrencyField
Get related MatterCustomCurrencyField
getMatters('{MatterId}')MatterCustomCurrencyField 1 param → 2004XX
GET
/Matters('{MatterId}')/MatterCustomRichTextAreaField
Get related MatterCustomRichTextAreaField
getMatters('{MatterId}')MatterCustomRichTextAreaField 1 param → 2004XX
GET
/Matters('{MatterId}')/MatterCustomNumberField
Get related MatterCustomNumberField
getMatters('{MatterId}')MatterCustomNumberField 1 param → 2004XX
GET
/Matters('{MatterId}')/MatterCustomDropdownField
Get related MatterCustomDropdownField
getMatters('{MatterId}')MatterCustomDropdownField 1 param → 2004XX
GET
/Matters('{MatterId}')/MatterCustomTextField
Get related MatterCustomTextField
getMatters('{MatterId}')MatterCustomTextField 1 param → 2004XX
GET
/Matters('{MatterId}')/MatterCustomDateField
Get related MatterCustomDateField
getMatters('{MatterId}')MatterCustomDateField 1 param → 2004XX
GET
/Matters('{MatterId}')/State
Get related State
getMatters('{MatterId}')State 1 param → 2004XX
GET
/Matters('{MatterId}')/MatterCustomTextAreaField
Get related MatterCustomTextAreaField
getMatters('{MatterId}')MatterCustomTextAreaField 1 param → 2004XX
GET
/Matters('{MatterId}')/MatterAllocation
Get related MatterAllocation
getMatters('{MatterId}')MatterAllocation 1 param → 2004XX
GET
/Matters('{MatterId}')/LeadCompanyPerson
Get related LeadCompanyPerson
getMatters('{MatterId}')LeadCompanyPerson 1 param → 2004XX
GET
/Matters('{MatterId}')/LeadOutsideCounsel
Get related LeadOutsideCounsel
getMatters('{MatterId}')LeadOutsideCounsel 1 param → 2004XX
GET
/Matters('{MatterId}')/MatterCreator
Get related MatterCreator
getMatters('{MatterId}')MatterCreator 1 param → 2004XX
GET
/Matters('{MatterId}')/No2CompanyPerson
Get related No2CompanyPerson
getMatters('{MatterId}')No2CompanyPerson 1 param → 2004XX
GET
/Matters('{MatterId}')/Accruals
Get entities from related Accruals
getMatters('{MatterId}')Accruals 6 params → 2004XX
GET
/Matters('{MatterId}')/Invoices
Get entities from related Invoices
getMatters('{MatterId}')Invoices 6 params → 2004XX
GET
/Matters('{MatterId}')/Budgets
Get entities from related Budgets
getMatters('{MatterId}')Budgets 6 params → 2004XX
GET
/Matters('{MatterId}')/InvoiceAllocations
Get entities from related InvoiceAllocations
getMatters('{MatterId}')InvoiceAllocations 6 params → 2004XX
GET
/Matters('{MatterId}')/InvoiceLines
Get entities from related InvoiceLines
getMatters('{MatterId}')InvoiceLines 6 params → 2004XX
GET
/Matters('{MatterId}')/Timekeepers
Get entities from related Timekeepers
getMatters('{MatterId}')Timekeepers 6 params → 2004XX
GET
/Matters('{MatterId}')/MatterFirms
Get entities from related MatterFirms
getMatters('{MatterId}')MatterFirms 6 params → 2004XX
GET
/Matters('{MatterId}')/TimekeeperRateSheets
Get entities from related TimekeeperRateSheets
getMatters('{MatterId}')TimekeeperRateSheets 6 params → 2004XX
GET
/Matters('{MatterId}')/MatterParticipants
Get entities from related MatterParticipants
getMatters('{MatterId}')MatterParticipants 6 params → 2004XX
GET
/Matters('{MatterId}')/InvoiceReductions
Get entities from related InvoiceReductions
getMatters('{MatterId}')InvoiceReductions 6 params → 2004XX
GET
/Matters('{MatterId}')/InvoiceTaxes
Get entities from related InvoiceTaxes
getMatters('{MatterId}')InvoiceTaxes 6 params → 2004XX
GET
/matters
Retrieves all matters
Matters_GetMatters 5 params → 200400401403
POST
/matters
Create a new matter record
Matters_PostMatter 1 param body → 201204400401403
GET
/matters/{id}
Find a matter by ID
Matters_GetMatter 1 param → 200401403404
PATCH
/matters/{id}
Update field values for an existing matter identified by the Tracker matter ID
Matters_PatchMatter 3 params body → 200204400401403404412415
GET
/matters/{id}/financials
Returns matter financials by ID
Matters_GetMatterFinancial 1 param → 200401403404
GET
/matters({key}='{value}')
Find a matter by Tracker Matter ID or Associated Matter ID in alternate keys…
Matters_GetMatterByAlternateKey 2 params → 200400401403404
PATCH
/matters({key}='{value}')
Update field values for an existing matter identified by the Tracker Matter ID…
Matters_PatchMatterByAlternateKey 4 params body → 200204400401403404412415
GET
/templates/{id}
Returns a matter template by id
Matters_GetMatterTemplate 1 param → 200401403404
GET
/templates
Returns a list of matter templates
Matters_GetMatterTemplates 4 params → 200401403
GET
/template-types
Returns a list of types for matter template
Matters_GetMatterTemplateTypes → 200401403
GET
/template-types/{id}
Returns a matter template type by ID
Matters_GetMatterTemplateType 1 param → 200401403404
GET
/fields
Returns a list of matter fields
Matters_GetMatterFields → 200401403
GET
/fields/{id}
Returns a matter field by ID
Matters_GetMatterField 1 param → 200400401403404

Schemas 68

The contract defines 68 schemas that model the data the API accepts and returns. The most detailed are MatterUploadModel (306 properties), MatterUploadCreationModel (298 properties), MatterUploadUpdateModel (297 properties), LegalTracker.Datawarehouse.Matter (85 properties). Each schema is shown below with its type and property counts.

LegalTracker.Datawarehouse.CustomNumberField
object
2 properties
LegalTracker.Datawarehouse.InvoiceLine
object
32 properties
LegalTracker.Datawarehouse.MatterCustomNumberField
object
13 properties
LegalTracker.Datawarehouse.MatterCustomDateField
object
23 properties
LegalTracker.Datawarehouse.MatterCustomDropdownField
object
43 properties
LegalTracker.Datawarehouse.MatterCustomTextField
object
23 properties
LegalTracker.Datawarehouse.CustomTextField
object
2 properties
LegalTracker.Datawarehouse.CustomDropdownField
object
2 properties
LegalTracker.Datawarehouse.MatterCustomRichTextAreaField
object
13 properties
LegalTracker.Datawarehouse.InvoiceReduction
object
12 properties
LegalTracker.Datawarehouse.MatterCreator
object
8 properties
LegalTracker.Datawarehouse.MatterCustomTextAreaField
object
15 properties
LegalTracker.Datawarehouse.MatterCustomCurrencyField
object
43 properties
LegalTracker.Datawarehouse.Accrual
object
7 properties
LegalTracker.Datawarehouse.CustomDateField
object
2 properties
ErrorResponse
object
1 property 1 required
LegalTracker.Datawarehouse.Firm
object
27 properties
LegalTracker.Datawarehouse.MatterType
object
6 properties
LegalTracker.Datawarehouse.Invoice
object
52 properties
LegalTracker.Datawarehouse.Timekeeper
object
24 properties
LegalTracker.Datawarehouse.TimekeeperRateSheet
object
37 properties
LegalTracker.Datawarehouse.SubstantiveLaw
object
6 properties
LegalTracker.Datawarehouse.MatterFirm
object
4 properties
LegalTracker.Datawarehouse.InvoiceTax
object
18 properties
LegalTracker.Datawarehouse.PracticeGroup
object
6 properties
LegalTracker.Datawarehouse.MatterParticipant
object
10 properties
LegalTracker.Datawarehouse.CustomTreeNodeField
object
2 properties
LegalTracker.Datawarehouse.MatterCustomTreeNodeField
object
7 properties
LegalTracker.Datawarehouse.CustomTextAreaField
object
2 properties
LegalTracker.Datawarehouse.OrgUnit
object
6 properties
LegalTracker.Datawarehouse.BilledToEntity
object
3 properties
LegalTracker.Datawarehouse.State
object
4 properties
LegalTracker.Datawarehouse.No2CompanyPerson
object
8 properties
LegalTracker.Datawarehouse.InvoiceAllocation
object
15 properties
LegalTracker.Datawarehouse.APRoute
object
3 properties
LegalTracker.Datawarehouse.MatterAllocation
object
17 properties
LegalTracker.Datawarehouse.LeadOutsideCounsel
object
9 properties
LegalTracker.Datawarehouse.LeadCompanyPerson
object
8 properties
LegalTracker.Datawarehouse.TimekeeperClassification
object
6 properties
LegalTracker.Datawarehouse.CustomCurrencyField
object
2 properties
LegalTracker.Datawarehouse.Matter
object
85 properties
LegalTracker.Datawarehouse.Budget
object
22 properties
LegalTracker.Datawarehouse.Country
object
6 properties
MatterTemplateType
object
Definition of matter template type.
7 properties 1 required
MatterTemplateFieldRequireOf
string
BudgetPhasedType
string
The phased of the budget.
ErrorResponse_2
object
1 property 1 required
MatterAllocationModel
object
12 properties
BudgetPeriodType
string
The periodicity of the budget. Read-only, required for validation.
MatterFieldValueForChoice
object
Definition of value for choice in list fields of template.
3 properties
DocumentManagementSystemIntegration
object
3 properties
MatterUploadUpdateModel
object
297 properties
MatterTemplateFieldFirmAccess
string
SpendingWithoutTaxExclusionModel
object
4 properties
MattersResponse
object
3 properties
Address
object
10 properties
MatterTemplate
object
Definition of matter template.
7 properties 3 required
ParticipatingFirm
object
2 properties
MatterField
object
Definition of matter field.
13 properties 5 required
MatterTemplateField
object
Definition of matter template field.
10 properties 1 required
MatterUploadCreationModel
object
298 properties 10 required
CompanyBudgetCurrency
string
The currency of the budget.
MatterFinancialModel
object
5 properties
MatterFieldType
string
SpendingWithTaxExclusionModel
object
5 properties
MatterUploadModel
object
306 properties
BudgetSourceType
string
The source of the budget, either company or firm.
ErrorResponse_3
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

thomson-reuters-matters-api-openapi.yml Raw ↑

Other APIs Thomson Reuters publishes across the network.

Thomson Reuters Westlaw API
Thomson Reuters Checkpoint API
Thomson Reuters Risk and Fraud API
Datasets API
Exports API
Tax Return Import/Export API
Companies API
Prints API
Reports API
Firms API
Users API
Thomson Reuters Account API
Where this information came from

This is an independent, third-party profile of Matters API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.