> ## Documentation Index > Fetch the complete documentation index at: https://www.worldmonitor.app/docs/llms.txt > Use this file to discover all available pages before exploring further. # ListLabelChanges > ListLabelChanges returns stories whose corroboration label moved between single-publisher and corroborated in the last seven days, with the publishers behind each change. ## OpenAPI ````yaml /api/NewsService.openapi.yaml get /api/news/v1/list-label-changes openapi: 3.1.0 info: title: NewsService API version: 1.0.0 servers: - url: https://api.worldmonitor.app security: - WorldMonitorKey: [] - ApiKeyHeader: [] paths: /api/news/v1/list-label-changes: get: tags: - NewsService summary: ListLabelChanges description: >- ListLabelChanges returns stories whose corroboration label moved between single-publisher and corroborated in the last seven days, with the publishers behind each change. operationId: ListLabelChanges parameters: - name: story_id in: query description: >- Story identity hash (64 hex characters). Empty lists changes across all stories. required: false example: example-id schema: type: string - name: limit in: query description: >- Maximum changes returned, newest first. 0 uses the default of 50; at most 200. required: false example: 25 schema: type: integer format: int32 - name: jmespath in: query description: >- Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath. required: false example: keys(@) schema: type: string responses: '200': description: Successful response content: application/json: example: changes: - at: 1767182400000 credibilityScore: 72 field: corroboration link: https://example.com/news/synthetic-example next: corroborated nextPublishers: 2 previous: single-publisher previousPublishers: 1 reason: 2 publisher families now carry this story (was 1). sources: - name: Example Wire (synthetic) tier: 1 - name: Example Daily (synthetic) tier: 2 storyId: >- aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa title: Synthetic example story trigger: digest counts: at: 1767182400000 corroborated: 64 singlePublisher: 51 stories: 120 tier4Only: 3 unknown: 2 retentionDays: 7 state: ok schema: $ref: '#/components/schemas/ListLabelChangesResponse' '400': description: Validation error content: application/json: schema: oneOf: - $ref: '#/components/schemas/ValidationError' - $ref: '#/components/schemas/JmespathProjectionError' '429': description: Rate limit exceeded. headers: X-RateLimit-Limit: description: Maximum requests allowed in the active rate-limit window. schema: type: string X-RateLimit-Remaining: description: Requests remaining in the active rate-limit window. schema: type: string X-RateLimit-Reset: description: >- Unix epoch milliseconds when the active rate-limit window resets. schema: type: string Retry-After: description: Seconds to wait before retrying the request. schema: type: string content: application/json: schema: oneOf: - $ref: '#/components/schemas/Error' - $ref: '#/components/schemas/RateLimitError' default: description: Gateway or handler error response. content: application/json: schema: oneOf: - $ref: '#/components/schemas/Error' - $ref: '#/components/schemas/GatewayError' security: [] components: schemas: ListLabelChangesResponse: type: object properties: changes: type: array items: $ref: '#/components/schemas/LabelChange' state: type: string description: >- ok | unavailable. Unavailable means the log could not be read, not that it is empty. retentionDays: type: integer format: int32 description: Retention window in days. counts: $ref: '#/components/schemas/LabelCounts' description: >- ListLabelChangesResponse lists changes from the last seven days, newest first. ValidationError: type: object properties: violations: type: array items: $ref: '#/components/schemas/FieldViolation' description: List of validation violations required: - violations description: >- ValidationError is returned when request validation fails. It contains a list of field violations describing what went wrong. JmespathProjectionError: description: >- Returned when a REST jmespath projection is invalid or exceeds the expression/output byte limits. properties: _jmespath_error: description: Projection error discriminator and details. type: string original_keys: description: Top-level keys or shape of the unprojected response. items: type: string type: array required: - _jmespath_error - original_keys type: object Error: type: object properties: message: type: string description: Error message (e.g., 'user not found', 'database connection failed') description: >- Error is returned when a handler encounters an error. It contains a simple error message that the developer can customize. RateLimitError: type: object description: Returned when a gateway or handler rate limit rejects the request. properties: error: type: string description: Human-readable rate-limit failure reason. required: - error GatewayError: type: object description: >- Returned by gateway infrastructure errors before an RPC handler runs, such as origin, routing, method, authentication, or quota checks. properties: error: oneOf: - type: string - type: object additionalProperties: true description: Gateway error reason or structured gateway failure details. required: - error LabelChange: type: object properties: storyId: type: string description: Story identity hash; empty for a correction that names no story. field: type: string description: >- corroboration (a label moved) | correction (an accepted reader report). previous: type: string description: >- Previous state: single-publisher | corroborated; empty for a correction. next: type: string description: 'New state: single-publisher | corroborated; empty for a correction.' previousPublishers: type: integer format: int32 description: Publisher families behind the previous label; 0 for a correction. nextPublishers: type: integer format: int32 description: Publisher families behind the new label; 0 for a correction. at: type: integer format: int64 description: >- Time the change was recorded, Unix epoch milliseconds.. Warning: Values > 2^53 may lose precision in JavaScript trigger: type: string description: >- What recorded it: digest (automatic) | report (an accepted error report). reason: type: string description: Plain-language reason, in English. sources: type: array items: $ref: '#/components/schemas/LabelChangePublisher' title: type: string description: Story headline when the change was recorded. link: type: string description: >- Representative article URL. Empty when it failed the publisher link gate, was revoked after the change was recorded, or the revocation set could not be read. credibilityScore: type: integer format: int32 description: >- Story CRED score 0-100 when the change was recorded; -1 when unknown. description: >- LabelChange records one story moving between single-publisher and corroborated coverage, or one correction a reviewer accepted from a reader report. LabelCounts: type: object properties: at: type: integer format: int64 description: >- When the digest counted, Unix epoch milliseconds.. Warning: Values > 2^53 may lose precision in JavaScript stories: type: integer format: int32 description: Stories counted. corroborated: type: integer format: int32 description: Two or more publisher families, not all tier 4. singlePublisher: type: integer format: int32 description: One publisher family. tier4Only: type: integer format: int32 description: Two or more families, every one a declared tier-4 outlet. unknown: type: integer format: int32 description: No evidence to judge. description: >- LabelCounts is how many stories in the latest full English digest carry each label. FieldViolation: type: object properties: field: type: string description: >- The field path that failed validation (e.g., 'user.email' for nested fields). For header validation, this will be the header name (e.g., 'X-API-Key') description: type: string description: >- Human-readable description of the validation violation (e.g., 'must be a valid email address', 'required field missing') required: - field - description description: FieldViolation describes a single validation error for a specific field. LabelChangePublisher: type: object properties: name: type: string description: Curated publisher name, or the feed label when no family is curated. tier: type: integer format: int32 description: Declared source tier 1-4; 0 when no feed label declares one. description: LabelChangePublisher is one publisher family behind the new label. securitySchemes: WorldMonitorKey: type: apiKey in: header name: X-WorldMonitor-Key description: User-issued WorldMonitor API key. ApiKeyHeader: type: apiKey in: header name: X-Api-Key description: Alias header for the WorldMonitor API key (X-WorldMonitor-Key). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.