> For the complete documentation index, see [llms.txt](https://docs.raalabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.raalabs.io/reference/api-reference/models.md).

# Models

## The BadRequestResponse object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"BadRequestResponse":{"properties":{"error":{"description":"Error message","type":"string"}},"title":"BadRequestResponse","type":"object"}}}}
```

## The CommonMetadata object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"CommonMetadata":{"description":"Properties common to all Metadata types","properties":{"description":{"type":"string"},"mapsTo":{"additionalProperties":{"type":"string"},"type":"object"},"name":{"type":"string"},"rangeHigh":{"type":"integer"},"rangeLow":{"type":"integer"},"scale":{"type":"number"},"source":{"type":"string"},"timeSeriesId":{"format":"uuid","type":"string"},"uom":{"type":"string"},"vesselImo":{"type":"string"},"vesselName":{"type":"string"}},"title":"CommonMetadata","type":"object"}}}}
```

## The IDMetadata object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"IDMetadata":{"allOf":[{"$ref":"#/components/schemas/CommonMetadata"}],"description":"Metadata from the Raalabs domain","title":"IDMetadata","type":"object"},"CommonMetadata":{"description":"Properties common to all Metadata types","properties":{"description":{"type":"string"},"mapsTo":{"additionalProperties":{"type":"string"},"type":"object"},"name":{"type":"string"},"rangeHigh":{"type":"integer"},"rangeLow":{"type":"integer"},"scale":{"type":"number"},"source":{"type":"string"},"timeSeriesId":{"format":"uuid","type":"string"},"uom":{"type":"string"},"vesselImo":{"type":"string"},"vesselName":{"type":"string"}},"title":"CommonMetadata","type":"object"}}}}
```

## The IdStatistics object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"IdStatistics":{"description":"Statistics response from the ID domain","items":{"$ref":"#/components/schemas/Statistics"},"title":"IdStatistics","type":"array"},"Statistics":{"additionalProperties":{"description":"Property containing the aggregated value","oneOf":[{"type":"number"},{"format":"date-time","type":"string"}]},"properties":{"timestamp":{"description":"The timestamp for this aggregation window","format":"date-time","type":"string"}},"title":"Statistics","type":"object"}}}}
```

## The IdTimeseries object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"IdTimeseries":{"items":{"$ref":"#/components/schemas/Measurement"},"title":"IdTimeseries","type":"array"},"Measurement":{"properties":{"id":{"format":"uuid","type":"string"},"timestamp":{"format":"date-time","type":"string"},"value":{"type":"number"}},"title":"Measurement","type":"object"}}}}
```

## The InternalServerErrorResponse object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"InternalServerErrorResponse":{"properties":{"error":{"description":"Error message","type":"string"}},"title":"InternalServerErrorResponse","type":"object"}}}}
```

## The JsmeaMetadata object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"JsmeaMetadata":{"allOf":[{"$ref":"#/components/schemas/CommonMetadata"}],"title":"JsmeaMetadata","type":"object"},"CommonMetadata":{"description":"Properties common to all Metadata types","properties":{"description":{"type":"string"},"mapsTo":{"additionalProperties":{"type":"string"},"type":"object"},"name":{"type":"string"},"rangeHigh":{"type":"integer"},"rangeLow":{"type":"integer"},"scale":{"type":"number"},"source":{"type":"string"},"timeSeriesId":{"format":"uuid","type":"string"},"uom":{"type":"string"},"vesselImo":{"type":"string"},"vesselName":{"type":"string"}},"title":"CommonMetadata","type":"object"}}}}
```

## The JsmeaStatistics object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"JsmeaStatistics":{"description":"Statistics response from the JSMEA domain. If multiple time series were matched by the query (e.g., using a wildcard expression), each aggregation result object may contain multiple different {id/Aggregation} fields, one for each series.","items":{"$ref":"#/components/schemas/Statistics"},"title":"JsmeaStatistics","type":"array"},"Statistics":{"additionalProperties":{"description":"Property containing the aggregated value","oneOf":[{"type":"number"},{"format":"date-time","type":"string"}]},"properties":{"timestamp":{"description":"The timestamp for this aggregation window","format":"date-time","type":"string"}},"title":"Statistics","type":"object"}}}}
```

## The JsmeaTimeseries object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"JsmeaTimeseries":{"items":{"$ref":"#/components/schemas/Measurement"},"title":"JsmeaTimeseries","type":"array"},"Measurement":{"properties":{"id":{"format":"uuid","type":"string"},"timestamp":{"format":"date-time","type":"string"},"value":{"type":"number"}},"title":"Measurement","type":"object"}}}}
```

## The Measurement object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"Measurement":{"properties":{"id":{"format":"uuid","type":"string"},"timestamp":{"format":"date-time","type":"string"},"value":{"type":"number"}},"title":"Measurement","type":"object"}}}}
```

## The MeasurementBatchQueryRequest object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"MeasurementBatchQueryRequest":{"description":"Array of domain/expression query strings","items":{"type":"string"},"minItems":1,"title":"MeasurementBatchQueryRequest","type":"array"}}}}
```

## The MeasurementBatchQueryResponse object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"MeasurementBatchQueryResponse":{"items":{"$ref":"#/components/schemas/Measurement"},"title":"MeasurementBatchQueryResponse","type":"array"},"Measurement":{"properties":{"id":{"format":"uuid","type":"string"},"timestamp":{"format":"date-time","type":"string"},"value":{"type":"number"}},"title":"Measurement","type":"object"}}}}
```

## The NotFoundErrorresponse object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"NotFoundErrorresponse":{"properties":{"error":{"description":"Error message","type":"string"}},"title":"NotFoundErrorresponse","type":"object"}}}}
```

## The RaalabsMetadata object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"RaalabsMetadata":{"allOf":[{"$ref":"#/components/schemas/CommonMetadata"}],"description":"Metadata from the Raalabs domain","title":"RaalabsMetadata","type":"object"},"CommonMetadata":{"description":"Properties common to all Metadata types","properties":{"description":{"type":"string"},"mapsTo":{"additionalProperties":{"type":"string"},"type":"object"},"name":{"type":"string"},"rangeHigh":{"type":"integer"},"rangeLow":{"type":"integer"},"scale":{"type":"number"},"source":{"type":"string"},"timeSeriesId":{"format":"uuid","type":"string"},"uom":{"type":"string"},"vesselImo":{"type":"string"},"vesselName":{"type":"string"}},"title":"CommonMetadata","type":"object"}}}}
```

## The RaalabsStatistics object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"RaalabsStatistics":{"description":"Statistics response from the Raalabs domain. If multiple time series were matched by the query (e.g., using a wildcard expression), each aggregation result object may contain multiple different {id/Aggregation} fields, one for each series.","items":{"$ref":"#/components/schemas/Statistics"},"title":"RaalabsStatistics","type":"array"},"Statistics":{"additionalProperties":{"description":"Property containing the aggregated value","oneOf":[{"type":"number"},{"format":"date-time","type":"string"}]},"properties":{"timestamp":{"description":"The timestamp for this aggregation window","format":"date-time","type":"string"}},"title":"Statistics","type":"object"}}}}
```

## The RaalabsTimeseries object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"RaalabsTimeseries":{"items":{"$ref":"#/components/schemas/Measurement"},"title":"RaalabsTimeseries","type":"array"},"Measurement":{"properties":{"id":{"format":"uuid","type":"string"},"timestamp":{"format":"date-time","type":"string"},"value":{"type":"number"}},"title":"Measurement","type":"object"}}}}
```

## The Statistics object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"Statistics":{"additionalProperties":{"description":"Property containing the aggregated value","oneOf":[{"type":"number"},{"format":"date-time","type":"string"}]},"properties":{"timestamp":{"description":"The timestamp for this aggregation window","format":"date-time","type":"string"}},"title":"Statistics","type":"object"}}}}
```

## The StatisticsBatchQueryRequest object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"StatisticsBatchQueryRequest":{"description":"","items":{"type":"string"},"minItems":1,"title":"StatisticsBatchQueryRequest","type":"array"}}}}
```

## The StatisticsBatchQueryResponse object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"StatisticsBatchQueryResponse":{"items":{"$ref":"#/components/schemas/Statistics"},"title":"StatisticsBatchQueryResponse","type":"array"},"Statistics":{"additionalProperties":{"description":"Property containing the aggregated value","oneOf":[{"type":"number"},{"format":"date-time","type":"string"}]},"properties":{"timestamp":{"description":"The timestamp for this aggregation window","format":"date-time","type":"string"}},"title":"Statistics","type":"object"}}}}
```

## The UnauthorizedErrorResponse object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"UnauthorizedErrorResponse":{"properties":{"error":{"description":"Error message","type":"string"}},"title":"UnauthorizedErrorResponse","type":"object"}}}}
```

## The Vis38Metadata object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"Vis38Metadata":{"items":{"properties":{"id":{"format":"uuid","type":"string"},"imo":{"type":"integer"},"vis_path":{"type":"string"}},"type":"object"},"title":"Vis38Metadata","type":"array"}}}}
```

## The Vis38Statistics object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"Vis38Statistics":{"description":"Statistics response from the Vis38 domain. If multiple time series were matched by the query (e.g., using a wildcard expression), each aggregation result object may contain multiple different {id/Aggregation} fields, one for each series.","items":{"$ref":"#/components/schemas/Statistics"},"title":"Vis38Statistics","type":"array"},"Statistics":{"additionalProperties":{"description":"Property containing the aggregated value","oneOf":[{"type":"number"},{"format":"date-time","type":"string"}]},"properties":{"timestamp":{"description":"The timestamp for this aggregation window","format":"date-time","type":"string"}},"title":"Statistics","type":"object"}}}}
```

## The Vis38Timeseries object

```json
{"openapi":"3.0.0","info":{"title":"Raa Labs Time Series API","version":"2025-10-31"},"components":{"schemas":{"Vis38Timeseries":{"items":{"$ref":"#/components/schemas/Measurement"},"title":"Vis38Timeseries","type":"array"},"Measurement":{"properties":{"id":{"format":"uuid","type":"string"},"timestamp":{"format":"date-time","type":"string"},"value":{"type":"number"}},"title":"Measurement","type":"object"}}}}
```
