{ "_id": "69e89d74df2753cf786ef002", "dedupeId": "NewsArticle::url(https://www.dw.com/en/czechias-lithium-mine-plans-spark-resistance/video-76878114)", "sourceService": "News Monitor", "title": "Czechia's lithium mine plans spark resistance", "content": [ "Plans to mine lithium in Cinovec, a mountain town on the Czech-German border, are dividing local communities. While the project promises jobs and investment...", "Plans to mine lithium in Cinovec, a mountain town on the Czech-German border, are dividing local communities. While the project promises jobs and investment, residents fear it could bring pollution and harm tourism.", "Czechia's lithium mine plans spark resistance", "In Cinovec, a small mountain town on the Czech- German border, plans to mine lithium have divided locals.", "Known for its clean air, forests and spa tourism, the region around Cinovec has reportedly got one of Europe's largest lithium deposits, a resource seen as vital to the green energy transition.", "According to Geomet, the company behind the project, mining will bring jobs and economic growth. But many residents fear it could harm the region's fragile ecosystem, which is still recovering from decades of coal mining.", "As miners scour Zambia for metals used in sustainable energy, locals are dealing with unchecked pollution." ], "textEmbedding": [ 0.123, -0.456, 0.789 ], "weight": { "Media Bias Multiplier": 1.992 }, "publishedAt": "2026-04-21T17:02:22.885Z", "addedAt": "2026-04-22T10:02:22.885Z", "clusterLabel": { "label": 3, "method": "Leiden" }, "url": "https://www.dw.com/en/czechias-lithium-mine-plans-spark-resistance/video-76878114"}
{
"success": false,
"errorCode": "UNAUTHORISED",
"message": "Unauthorized access - API Key is missing or invalid"
}
{
"success": false,
"errorCode": "FORBIDDEN",
"message": "API Key not subscribed to this endpoint"
}
{
"success": false,
"errorCode": "NOT_FOUND",
"message": "Observation with the given ID not found"
}
{
"success": false,
"errorCode": "INTERNAL_SERVER_ERROR",
"message": "Internal Server Error"
}
Events Monitor
Get an Observation
Retrieves a single observation based on the provided observation ID.
Subscription Endpoint
This endpoint has a special subscription requirement. Your API Key needs to be
subscribed to this endpoint in order to access it; otherwise it will return a 403
Forbidden error. Please contact Forestreet support to get subscribed.
An Observation is a piece of information or data point that has been collected and
stored in our system. It serves as the foundational unit of information to join
together as Events, and can represent various types of data such as news articles,
social media posts, analyst reports, or any other relevant information that we want to
track and analyze. Each observation contains metadata about its source, content,
publication time, and other relevant attributes that allow us to process and analyze
it effectively.
GET
/
v2
/
events-monitor
/
observation
/
{observationId}
Get an Observation
curl --request GET \ --url http://localhost:4000/v2/events-monitor/observation/{observationId} \ --header 'x-api-key: <api-key>'
{ "_id": "69e89d74df2753cf786ef002", "dedupeId": "NewsArticle::url(https://www.dw.com/en/czechias-lithium-mine-plans-spark-resistance/video-76878114)", "sourceService": "News Monitor", "title": "Czechia's lithium mine plans spark resistance", "content": [ "Plans to mine lithium in Cinovec, a mountain town on the Czech-German border, are dividing local communities. While the project promises jobs and investment...", "Plans to mine lithium in Cinovec, a mountain town on the Czech-German border, are dividing local communities. While the project promises jobs and investment, residents fear it could bring pollution and harm tourism.", "Czechia's lithium mine plans spark resistance", "In Cinovec, a small mountain town on the Czech- German border, plans to mine lithium have divided locals.", "Known for its clean air, forests and spa tourism, the region around Cinovec has reportedly got one of Europe's largest lithium deposits, a resource seen as vital to the green energy transition.", "According to Geomet, the company behind the project, mining will bring jobs and economic growth. But many residents fear it could harm the region's fragile ecosystem, which is still recovering from decades of coal mining.", "As miners scour Zambia for metals used in sustainable energy, locals are dealing with unchecked pollution." ], "textEmbedding": [ 0.123, -0.456, 0.789 ], "weight": { "Media Bias Multiplier": 1.992 }, "publishedAt": "2026-04-21T17:02:22.885Z", "addedAt": "2026-04-22T10:02:22.885Z", "clusterLabel": { "label": 3, "method": "Leiden" }, "url": "https://www.dw.com/en/czechias-lithium-mine-plans-spark-resistance/video-76878114"}
An array of text snippets that provide the content of the observation. For news articles, this may include the article summary, key sentences, or other relevant text extracted from the article. If an article failed to scrape, it may only contain 1 content item which is the search engine snippet.
The content items may have been pruned before being stored on our system, so that only the most relevant information is retained. It is not guaranteed to be the full text of the original source.
Example:
[ "Plans to mine lithium in Cinovec, a mountain town on the Czech-German border, are dividing local communities. While the project promises jobs and investment...", "Plans to mine lithium in Cinovec, a mountain town on the Czech-German border, are dividing local communities. While the project promises jobs and investment, residents fear it could bring pollution and harm tourism.", "Czechia's lithium mine plans spark resistance", "In Cinovec, a small mountain town on the Czech- German border, plans to mine lithium have divided locals.", "Known for its clean air, forests and spa tourism, the region around Cinovec has reportedly got one of Europe's largest lithium deposits, a resource seen as vital to the green energy transition.", "According to Geomet, the company behind the project, mining will bring jobs and economic growth. But many residents fear it could harm the region's fragile ecosystem, which is still recovering from decades of coal mining.", "As miners scour Zambia for metals used in sustainable energy, locals are dealing with unchecked pollution." ]
A dictionary of weights for the observation, where the keys are weight names (e.g. 'Media Bias Multiplier') and the values are the corresponding weight values. These weights can be used to adjust the importance of the observation in various algorithms, such as event clustering or impact assessment.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Forestreet Documentation","colors":{"primary":"#0f62fe","light":"#0f62fe","dark":"#0f62fe"},"logo":{"light":"https://mintcdn.com/forestreet/bIVkQ4GpCRS8XyuT/logo/light.svg?fit=max\u0026auto=format\u0026n=bIVkQ4GpCRS8XyuT\u0026q=85\u0026s=bb2088ad5c6417fe9c8a2dab698d078b","dark":"https://mintcdn.com/forestreet/bIVkQ4GpCRS8XyuT/logo/dark.svg?fit=max\u0026auto=format\u0026n=bIVkQ4GpCRS8XyuT\u0026q=85\u0026s=8eb2a2e532744e3268f23f81b8ea2c5f"},"favicon":"https://mintcdn.com/forestreet/pahclZuClwwwBpfa/logo/favicon.png?fit=max\u0026auto=format\u0026n=pahclZuClwwwBpfa\u0026q=85\u0026s=add91905c589606383cb1c7bd7e664bf","background":{"color":{"dark":"#0f1726"}},"navbar":{"links":[{"href":"https://forestreet.com/contact-us","label":"Contact Us"}],"primary":{"type":"button","label":"Platform","href":"https://ailsa.forestreet.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"forestreet","hasAudioNarration":false,"actualSubdomain":"forestreet","customDomains":["docs.forestreet.com"],"gitSource":{"type":"github","owner":"forestreet","repo":"forestreet-api","deployBranch":"main","contentDirectory":"docs/mintlify","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af31883e49ad3dd9a8eb68c","clientVersion":"0.0.4124","searchFilterCounts":[{"language":"default","tag":"API Reference","count":50},{"language":"default","tag":"V1 (Deprecated)","count":24},{"language":"default","tag":"Market Intelligence","count":19},{"language":"default","tag":"Team Management","count":16},{"language":"default","tag":"Markets","count":14},{"language":"default","tag":"Market","count":11},{"language":"default","tag":"Companies","count":7},{"language":"default","tag":"Deprecated","count":5},{"language":"default","tag":"Discovery Process","count":5},{"language":"default","tag":"Supplier Dossier","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoints/events-monitor/get-an-observation","slug":"/api-reference/endpoints/events-monitor/get-an-observation","pageMetadata":{"openapi":"get /v2/events-monitor/observation/{observationId}","title":"Get an Observation","description":"\n Retrieves a single observation based on the provided observation ID.\n\n \u003cInfo>\n **Subscription Endpoint**\n\n This endpoint has a special subscription requirement. Your API Key needs to be\n subscribed to this endpoint in order to access it; otherwise it will return a 403\n Forbidden error. Please contact Forestreet support to get subscribed.\n \u003c/Info>\n\n An Observation is a piece of information or data point that has been collected and\n stored in our system. It serves as the foundational unit of information to join\n together as Events, and can represent various types of data such as news articles,\n social media posts, analyst reports, or any other relevant information that we want to\n track and analyze. Each observation contains metadata about its source, content,\n publication time, and other relevant attributes that allow us to process and analyze\n it effectively.\n ","href":"/api-reference/endpoints/events-monitor/get-an-observation"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n }, {Info} = _components;\n if (!Info) _missingMdxReference(\"Info\", true);\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Retrieves a single observation based on the provided observation ID.\"\n }), \"\\n\", _jsxs(Info, {\n children: [_jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Subscription Endpoint\"\n })\n }), _jsx(_components.p, {\n children: \"This endpoint has a special subscription requirement. Your API Key needs to be\\nsubscribed to this endpoint in order to access it; otherwise it will return a 403\\nForbidden error. Please contact Forestreet support to get subscribed.\"\n })]\n }), \"\\n\", _jsx(_components.p, {\n children: \"An Observation is a piece of information or data point that has been collected and\\nstored in our system. It serves as the foundational unit of information to join\\ntogether as Events, and can represent various types of data such as news articles,\\nsocial media posts, analyst reports, or any other relevant information that we want to\\ntrack and analyze. Each observation contains metadata about its source, content,\\npublication time, and other relevant attributes that allow us to process and analyze\\nit effectively.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"get /v2/events-monitor/observation/{observationId}","title":"Get an Observation","description":"\n Retrieves a single observation based on the provided observation ID.\n\n \u003cInfo>\n **Subscription Endpoint**\n\n This endpoint has a special subscription requirement. Your API Key needs to be\n subscribed to this endpoint in order to access it; otherwise it will return a 403\n Forbidden error. Please contact Forestreet support to get subscribed.\n \u003c/Info>\n\n An Observation is a piece of information or data point that has been collected and\n stored in our system. It serves as the foundational unit of information to join\n together as Events, and can represent various types of data such as news articles,\n social media posts, analyst reports, or any other relevant information that we want to\n track and analyze. Each observation contains metadata about its source, content,\n publication time, and other relevant attributes that allow us to process and analyze\n it effectively.\n ","href":"/api-reference/endpoints/events-monitor/get-an-observation"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Events Monitor"],"summary":"Get an Observation","description":"\n Retrieves a single observation based on the provided observation ID.\n\n \u003cInfo>\n **Subscription Endpoint**\n\n This endpoint has a special subscription requirement. Your API Key needs to be\n subscribed to this endpoint in order to access it; otherwise it will return a 403\n Forbidden error. Please contact Forestreet support to get subscribed.\n \u003c/Info>\n\n An Observation is a piece of information or data point that has been collected and\n stored in our system. It serves as the foundational unit of information to join\n together as Events, and can represent various types of data such as news articles,\n social media posts, analyst reports, or any other relevant information that we want to\n track and analyze. Each observation contains metadata about its source, content,\n publication time, and other relevant attributes that allow us to process and analyze\n it effectively.\n ","parameters":["3b37fba8-8f94-4c32-aaa2-d881e19303de"],"responses":{"200":"f9251990-9577-4581-acfe-7aad8d44d932","400":"f2f734e0-ac08-4566-ab65-613ded63531b","401":"6af3dc30-ac33-47a4-bf4a-dd039001c640","403":"fbd15d03-1f29-40c9-8ba3-588591532be2","404":"3ac21dce-ef94-4851-a727-9ab2e4d80bc0","500":"484199ed-5b57-492f-9603-892fb088446a"},"method":"get","type":"path","servers":["ab14d94c-c153-424f-9ad2-f78ba394ba10","8a9719d1-775b-4685-beef-f334ce26394b"],"security":["dada571b-2670-42f9-b9b9-017cef056f7e","5bf84088-879d-4093-afd8-d713e7b0d74f","bb569b71-dd41-4045-a7de-1ad2213d94b1"],"path":"/v2/events-monitor/observation/{observationId}","baseUrlOptions":["http://localhost:4000","https://rest-dev.forestreet.com"],"title":"Get an Observation","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"3b37fba8-8f94-4c32-aaa2-d881e19303de":{"schema":{"type":"string","description":"The unique identifier of the observation","example":"69e89d74df2753cf786ef002","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"The unique identifier of the observation","name":"observationId","in":"path"}},"responses":{"f9251990-9577-4581-acfe-7aad8d44d932":{"description":"The response containing pagination metadata, and an array of zero or more events that satisfy the query parameters.","content":{"application/json":{"schema":{"type":"object","properties":{"_id":{"type":"string","description":"Unique identifier for the observation","example":"69e89d74df2753cf786ef002","isRequired":true,"uniqueKey":"_id","typeLabel":"string"},"dedupeId":{"type":"string","description":"A deduplication identifier for the observation, used to identify and merge duplicate observations.","example":"NewsArticle::url(https://www.dw.com/en/czechias-lithium-mine-plans-spark-resistance/video-76878114)","isRequired":true,"uniqueKey":"dedupeId","typeLabel":"string"},"sourceService":{"type":"string","description":"The service from which the observation was sourced, e.g. 'News Monitor'.","example":"News Monitor","isRequired":true,"uniqueKey":"sourceService","typeLabel":"string"},"title":{"type":"string","description":"Title of the observation. For news articles, this will typically be the native title of the article from the publisher.","example":"Czechia's lithium mine plans spark resistance","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"content":{"type":"array","items":{"type":"string","uniqueKey":"content.items.[INDEX]","typeLabel":"string"},"description":"An array of text snippets that provide the content of the observation. For news articles, this may include the article summary, key sentences, or other relevant text extracted from the article. If an article failed to scrape, it may only contain 1 content item which is the search engine snippet.\n\nThe content items may have been pruned before being stored on our system, so that only the most relevant information is retained. It is not guaranteed to be the full text of the original source.","example":["Plans to mine lithium in Cinovec, a mountain town on the Czech-German border, are dividing local communities. While the project promises jobs and investment...","Plans to mine lithium in Cinovec, a mountain town on the Czech-German border, are dividing local communities. While the project promises jobs and investment, residents fear it could bring pollution and harm tourism.","Czechia's lithium mine plans spark resistance","In Cinovec, a small mountain town on the Czech- German border, plans to mine lithium have divided locals.","Known for its clean air, forests and spa tourism, the region around Cinovec has reportedly got one of Europe's largest lithium deposits, a resource seen as vital to the green energy transition.","According to Geomet, the company behind the project, mining will bring jobs and economic growth. But many residents fear it could harm the region's fragile ecosystem, which is still recovering from decades of coal mining.","As miners scour Zambia for metals used in sustainable energy, locals are dealing with unchecked pollution."],"isRequired":true,"uniqueKey":"content","typeLabel":"string[]"},"textEmbedding":{"type":"array","items":{"type":"number","uniqueKey":"textEmbedding.items.[INDEX]","typeLabel":"number"},"description":"An array of numbers representing the embedding vector for the observation's content.","example":[0.123,-0.456,0.789],"isRequired":true,"uniqueKey":"textEmbedding","typeLabel":"number[]"},"weight":{"type":"object","additionalProperties":{"type":"number","uniqueKey":"weight.additionalProperties","typeLabel":"number"},"description":"A dictionary of weights for the observation, where the keys are weight names (e.g. 'Media Bias Multiplier') and the values are the corresponding weight values. These weights can be used to adjust the importance of the observation in various algorithms, such as event clustering or impact assessment.","example":{"Media Bias Multiplier":1.992},"isRequired":true,"uniqueKey":"weight","typeLabel":"object"},"publishedAt":{"oneOf":[{"type":"string","format":"date-time","description":"The date and time when the observation was published or recorded. These are always UTC.","example":"2026-04-21T17:02:22.885Z","isRequired":true,"uniqueKey":"publishedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"The date and time when the observation was published or recorded. These are always UTC.","example":"2026-04-21T17:02:22.885Z","isRequired":true,"uniqueKey":"publishedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"publishedAt","typeLabel":"string\u003cdate-time> | null"},"addedAt":{"oneOf":[{"type":"string","format":"date-time","description":"The date and time when the observation was added to our system. These are always UTC.","example":"2026-04-22T10:02:22.885Z","isRequired":true,"uniqueKey":"addedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"The date and time when the observation was added to our system. These are always UTC.","example":"2026-04-22T10:02:22.885Z","isRequired":true,"uniqueKey":"addedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"addedAt","typeLabel":"string\u003cdate-time> | null"},"clusterLabel":{"type":"object","properties":{"label":{"type":"number","description":"The cluster label, represented as an integer. Observations with the same cluster label are considered to belong to the same event cluster.","example":3,"isRequired":true,"uniqueKey":"clusterLabel.label","typeLabel":"number"},"method":{"type":"string","description":"The method used to determine the cluster label. For internal use only, the exact value of this field can change without notice.","example":"Leiden","isRequired":true,"uniqueKey":"clusterLabel.method","typeLabel":"string"}},"required":["label","method"],"description":"The cluster label assigned to this observation, if it has been clustered.","uniqueKey":"clusterLabel","typeLabel":"object"},"url":{"type":"string","format":"uri","description":"URL of the observation, if it was sourced and scraped from the internet. Only available on publicly sourced observations such as News Articles.","example":"https://www.dw.com/en/czechias-lithium-mine-plans-spark-resistance/video-76878114","uniqueKey":"url","typeLabel":"string\u003curi>"}},"required":["_id","dedupeId","sourceService","title","content","textEmbedding","weight","publishedAt","addedAt"],"additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"additionalProperties","typeLabel":"null"},"description":"The response schema for the Get Observation endpoint.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"_id":"69e89d74df2753cf786ef002","dedupeId":"NewsArticle::url(https://www.dw.com/en/czechias-lithium-mine-plans-spark-resistance/video-76878114)","sourceService":"News Monitor","title":"Czechia's lithium mine plans spark resistance","content":["Plans to mine lithium in Cinovec, a mountain town on the Czech-German border, are dividing local communities. While the project promises jobs and investment...","Plans to mine lithium in Cinovec, a mountain town on the Czech-German border, are dividing local communities. While the project promises jobs and investment, residents fear it could bring pollution and harm tourism.","Czechia's lithium mine plans spark resistance","In Cinovec, a small mountain town on the Czech- German border, plans to mine lithium have divided locals.","Known for its clean air, forests and spa tourism, the region around Cinovec has reportedly got one of Europe's largest lithium deposits, a resource seen as vital to the green energy transition.","According to Geomet, the company behind the project, mining will bring jobs and economic growth. But many residents fear it could harm the region's fragile ecosystem, which is still recovering from decades of coal mining.","As miners scour Zambia for metals used in sustainable energy, locals are dealing with unchecked pollution."],"textEmbedding":[0.123,-0.456,0.789],"weight":{"Media Bias Multiplier":1.992},"publishedAt":"2026-04-21T17:02:22.885Z","addedAt":"2026-04-22T10:02:22.885Z","clusterLabel":{"label":3,"method":"Leiden"},"url":"https://www.dw.com/en/czechias-lithium-mine-plans-spark-resistance/video-76878114"}}},"exampleType":"generated"}},"exampleType":"generated"},"f2f734e0-ac08-4566-ab65-613ded63531b":{"description":"Invalid query parameters","content":{"application/json":{"examples":{"QUERY_VALIDATION_FAILED":{"title":"QUERY_VALIDATION_FAILED","value":{"success":false,"errorCode":"QUERY_VALIDATION_FAILED","message":"Invalid query parameters"}}},"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"errorCode":{"type":"string","enum":["USER_NOT_CONFIRMED","INVALID_CREDENTIALS","INCOMPLETE_CREDENTIALS","INVALID_SESSION_TOKEN","FORCE_CHANGE_PASSWORD","PASSWORD_RESET_REQUIRED","PASSWORD_EXPIRED","CODE_EXPIRED","SESSION_EXPIRED","UNAUTHORISED","AUTHENTICATOR_ERROR","SSO_ACCOUNT","FORBIDDEN","METHOD_NOT_ALLOWED","INVALID_INPUT","PATH_VALIDATION_FAILED","QUERY_VALIDATION_FAILED","BODY_VALIDATION_FAILED","RESPONSE_VALIDATION_FAILED","INVALID_OR_MALFORMED_JSON","INTERNAL_SERVER_ERROR","CONFIGURATION_ERROR","SERVICE_UNAVAILABLE","NOT_FOUND","CONFLICT","LIMIT_EXCEEDED","REVIEW_ALREADY_PENDING","REVIEW_NOT_PENDING","REVIEW_PENDING","REVIEW_INSUFFICIENT_DOMAINS","QUOTA_EXCEEDED","UNSUPPORTED_ENDPOINT_VERSION","ENDPOINT_NOT_FOUND","ENDPOINT_ALREADY_EXISTS"],"isRequired":true,"uniqueKey":"errorCode","typeLabel":"enum\u003cstring>"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"detail":{"type":"object","additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"detail.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail.additionalProperties","typeLabel":"null"},"uniqueKey":"detail","typeLabel":"object"}},"required":["success","errorCode"],"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"6af3dc30-ac33-47a4-bf4a-dd039001c640":{"description":"Unauthorized access - API Key is missing or invalid","content":{"application/json":{"examples":{"UNAUTHORISED":{"title":"UNAUTHORISED","value":{"success":false,"errorCode":"UNAUTHORISED","message":"Unauthorized access - API Key is missing or invalid"}}},"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"errorCode":{"type":"string","enum":["USER_NOT_CONFIRMED","INVALID_CREDENTIALS","INCOMPLETE_CREDENTIALS","INVALID_SESSION_TOKEN","FORCE_CHANGE_PASSWORD","PASSWORD_RESET_REQUIRED","PASSWORD_EXPIRED","CODE_EXPIRED","SESSION_EXPIRED","UNAUTHORISED","AUTHENTICATOR_ERROR","SSO_ACCOUNT","FORBIDDEN","METHOD_NOT_ALLOWED","INVALID_INPUT","PATH_VALIDATION_FAILED","QUERY_VALIDATION_FAILED","BODY_VALIDATION_FAILED","RESPONSE_VALIDATION_FAILED","INVALID_OR_MALFORMED_JSON","INTERNAL_SERVER_ERROR","CONFIGURATION_ERROR","SERVICE_UNAVAILABLE","NOT_FOUND","CONFLICT","LIMIT_EXCEEDED","REVIEW_ALREADY_PENDING","REVIEW_NOT_PENDING","REVIEW_PENDING","REVIEW_INSUFFICIENT_DOMAINS","QUOTA_EXCEEDED","UNSUPPORTED_ENDPOINT_VERSION","ENDPOINT_NOT_FOUND","ENDPOINT_ALREADY_EXISTS"],"isRequired":true,"uniqueKey":"errorCode","typeLabel":"enum\u003cstring>"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"detail":{"type":"object","additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"detail.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail.additionalProperties","typeLabel":"null"},"uniqueKey":"detail","typeLabel":"object"}},"required":["success","errorCode"],"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"fbd15d03-1f29-40c9-8ba3-588591532be2":{"description":"API Key not subscribed to this endpoint","content":{"application/json":{"examples":{"FORBIDDEN":{"title":"FORBIDDEN","value":{"success":false,"errorCode":"FORBIDDEN","message":"API Key not subscribed to this endpoint"}}},"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"errorCode":{"type":"string","enum":["USER_NOT_CONFIRMED","INVALID_CREDENTIALS","INCOMPLETE_CREDENTIALS","INVALID_SESSION_TOKEN","FORCE_CHANGE_PASSWORD","PASSWORD_RESET_REQUIRED","PASSWORD_EXPIRED","CODE_EXPIRED","SESSION_EXPIRED","UNAUTHORISED","AUTHENTICATOR_ERROR","SSO_ACCOUNT","FORBIDDEN","METHOD_NOT_ALLOWED","INVALID_INPUT","PATH_VALIDATION_FAILED","QUERY_VALIDATION_FAILED","BODY_VALIDATION_FAILED","RESPONSE_VALIDATION_FAILED","INVALID_OR_MALFORMED_JSON","INTERNAL_SERVER_ERROR","CONFIGURATION_ERROR","SERVICE_UNAVAILABLE","NOT_FOUND","CONFLICT","LIMIT_EXCEEDED","REVIEW_ALREADY_PENDING","REVIEW_NOT_PENDING","REVIEW_PENDING","REVIEW_INSUFFICIENT_DOMAINS","QUOTA_EXCEEDED","UNSUPPORTED_ENDPOINT_VERSION","ENDPOINT_NOT_FOUND","ENDPOINT_ALREADY_EXISTS"],"isRequired":true,"uniqueKey":"errorCode","typeLabel":"enum\u003cstring>"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"detail":{"type":"object","additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"detail.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail.additionalProperties","typeLabel":"null"},"uniqueKey":"detail","typeLabel":"object"}},"required":["success","errorCode"],"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"3ac21dce-ef94-4851-a727-9ab2e4d80bc0":{"description":"Observation with the given ID not found","content":{"application/json":{"examples":{"NOT_FOUND":{"title":"NOT_FOUND","value":{"success":false,"errorCode":"NOT_FOUND","message":"Observation with the given ID not found"}}},"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"errorCode":{"type":"string","enum":["USER_NOT_CONFIRMED","INVALID_CREDENTIALS","INCOMPLETE_CREDENTIALS","INVALID_SESSION_TOKEN","FORCE_CHANGE_PASSWORD","PASSWORD_RESET_REQUIRED","PASSWORD_EXPIRED","CODE_EXPIRED","SESSION_EXPIRED","UNAUTHORISED","AUTHENTICATOR_ERROR","SSO_ACCOUNT","FORBIDDEN","METHOD_NOT_ALLOWED","INVALID_INPUT","PATH_VALIDATION_FAILED","QUERY_VALIDATION_FAILED","BODY_VALIDATION_FAILED","RESPONSE_VALIDATION_FAILED","INVALID_OR_MALFORMED_JSON","INTERNAL_SERVER_ERROR","CONFIGURATION_ERROR","SERVICE_UNAVAILABLE","NOT_FOUND","CONFLICT","LIMIT_EXCEEDED","REVIEW_ALREADY_PENDING","REVIEW_NOT_PENDING","REVIEW_PENDING","REVIEW_INSUFFICIENT_DOMAINS","QUOTA_EXCEEDED","UNSUPPORTED_ENDPOINT_VERSION","ENDPOINT_NOT_FOUND","ENDPOINT_ALREADY_EXISTS"],"isRequired":true,"uniqueKey":"errorCode","typeLabel":"enum\u003cstring>"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"detail":{"type":"object","additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"detail.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail.additionalProperties","typeLabel":"null"},"uniqueKey":"detail","typeLabel":"object"}},"required":["success","errorCode"],"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"484199ed-5b57-492f-9603-892fb088446a":{"description":"Internal Server Error","content":{"application/json":{"examples":{"INTERNAL_SERVER_ERROR":{"title":"INTERNAL_SERVER_ERROR","value":{"success":false,"errorCode":"INTERNAL_SERVER_ERROR","message":"Internal Server Error"}}},"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"errorCode":{"type":"string","enum":["USER_NOT_CONFIRMED","INVALID_CREDENTIALS","INCOMPLETE_CREDENTIALS","INVALID_SESSION_TOKEN","FORCE_CHANGE_PASSWORD","PASSWORD_RESET_REQUIRED","PASSWORD_EXPIRED","CODE_EXPIRED","SESSION_EXPIRED","UNAUTHORISED","AUTHENTICATOR_ERROR","SSO_ACCOUNT","FORBIDDEN","METHOD_NOT_ALLOWED","INVALID_INPUT","PATH_VALIDATION_FAILED","QUERY_VALIDATION_FAILED","BODY_VALIDATION_FAILED","RESPONSE_VALIDATION_FAILED","INVALID_OR_MALFORMED_JSON","INTERNAL_SERVER_ERROR","CONFIGURATION_ERROR","SERVICE_UNAVAILABLE","NOT_FOUND","CONFLICT","LIMIT_EXCEEDED","REVIEW_ALREADY_PENDING","REVIEW_NOT_PENDING","REVIEW_PENDING","REVIEW_INSUFFICIENT_DOMAINS","QUOTA_EXCEEDED","UNSUPPORTED_ENDPOINT_VERSION","ENDPOINT_NOT_FOUND","ENDPOINT_ALREADY_EXISTS"],"isRequired":true,"uniqueKey":"errorCode","typeLabel":"enum\u003cstring>"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"detail":{"type":"object","additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"detail.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail.additionalProperties","typeLabel":"null"},"uniqueKey":"detail","typeLabel":"object"}},"required":["success","errorCode"],"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"dada571b-2670-42f9-b9b9-017cef056f7e":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Pass a static API key for every request, provided by your customer support.","scopes":[],"schemeName":"apiKeyAuth"}},"5bf84088-879d-4093-afd8-d713e7b0d74f":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Bearer token authentication, using a sessionId generated by `GET /v2/auth/session`.","scopes":[],"schemeName":"bearerAuth"}},"bb569b71-dd41-4045-a7de-1ad2213d94b1":{"sessionIdQuery":{"type":"apiKey","in":"query","name":"sessionId","description":"Session ID passed as a query parameter for authentication, provided by `GET /v2/auth/session`.","scopes":[],"schemeName":"sessionIdQuery"}}},"servers":{"ab14d94c-c153-424f-9ad2-f78ba394ba10":{"url":"http://localhost:4000","description":"Local server"},"8a9719d1-775b-4685-beef-f334ce26394b":{"url":"https://rest-dev.forestreet.com","description":"Development server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Pass a static API key for every request, provided by your customer support.","scopes":[],"schemeName":"apiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"Pass a static API key for every request, provided by your customer support.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"x-api-key"}],"title":"apiKeyAuth"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Bearer token authentication, using a sessionId generated by `GET /v2/auth/session`.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer token authentication, using a sessionId generated by `GET /v2/auth/session`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"query","name":"sessionId","description":"Session ID passed as a query parameter for authentication, provided by `GET /v2/auth/session`.","scopes":[],"schemeName":"sessionIdQuery"},"schema":{"title":"sessionId","type":"string","description":"Session ID passed as a query parameter for authentication, provided by `GET /v2/auth/session`.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"sessionIdQuery","name":"sessionId"}],"title":"sessionIdQuery"}]},"originalFileLocation":"openapi.json"},"subdomain":"forestreet","siteName":"Forestreet Documentation","title":"Get an Observation - Forestreet Documentation","navMaps":{"firstHrefInVersion":{"2.0":{"href":"/api-reference/endpoints/events-monitor/get-an-observation","matchLevel":0},"1.0 (Deprecated)":{"href":"/api-reference/deprecated/v1","matchLevel":3}},"firstHrefInLanguage":{}},"lastModified":"2026-05-11T14:38:00.697Z","originalFileLocation":"api-reference/endpoints/events-monitor/get-an-observation.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieves a single observation based on the provided observation ID. Subscription Endpoint This endpoint has a special subscription requirement. Your API Key needs to be subscribed to this endpoint in order to access it; otherwise it will return a 403 Forbidden error. Please contact Forestreet support to get subscribed. An Observation is a piece of information or data point that has been collected and stored in our system. It serves as the foundational unit of information to join together as Events, and can represent various types of data such as news articles, social media posts, analyst reports, or any other relevant information that we want to track and analyze. Each observation contains metadata about its source, content, publication time, and other relevant attributes that allow us to process and analyze it effectively.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Forestreet Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/forestreet/CQ9RrLPrT2waDRGc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/forestreet/CQ9RrLPrT2waDRGc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/forestreet/CQ9RrLPrT2waDRGc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/forestreet/CQ9RrLPrT2waDRGc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/forestreet/CQ9RrLPrT2waDRGc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/forestreet/CQ9RrLPrT2waDRGc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/forestreet/CQ9RrLPrT2waDRGc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/forestreet/CQ9RrLPrT2waDRGc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/forestreet/CQ9RrLPrT2waDRGc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get an Observation - Forestreet Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieves a single observation based on the provided observation ID. Subscription Endpoint This endpoint has a special subscription requirement. Your API Key needs to be subscribed to this endpoint in order to access it; otherwise it will return a 403 Forbidden error. Please contact Forestreet support to get subscribed. An Observation is a piece of information or data point that has been collected and stored in our system. It serves as the foundational unit of information to join together as Events, and can represent various types of data such as news articles, social media posts, analyst reports, or any other relevant information that we want to track and analyze. Each observation contains metadata about its source, content, publication time, and other relevant attributes that allow us to process and analyze it effectively.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Forestreet Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.forestreet.com/api-reference/endpoints/events-monitor/get-an-observation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://forestreet.mintlify.site/_mintlify/api/og/v2?division=Events+Monitor\u0026amp;title=Get+an+Observation\u0026amp;description=%0A++Retrieves+a+single+observation+based+on+the+provided+observation+ID.%0A%0A++%3CInfo%3E%0A++**Subscription+Endpoint**%0A%0A++This+endpoint+has+a+special+subscription+requir\u0026amp;theme=acb3b42503ddba11d1ec590b\u0026amp;signature=4a17ae70c8fd8c08b4069f82a78ca379a9a835b1f320811fa2a8e9ef67f7ac00\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get an Observation - Forestreet Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieves a single observation based on the provided observation ID. Subscription Endpoint This endpoint has a special subscription requirement. Your API Key needs to be subscribed to this endpoint in order to access it; otherwise it will return a 403 Forbidden error. Please contact Forestreet support to get subscribed. An Observation is a piece of information or data point that has been collected and stored in our system. It serves as the foundational unit of information to join together as Events, and can represent various types of data such as news articles, social media posts, analyst reports, or any other relevant information that we want to track and analyze. Each observation contains metadata about its source, content, publication time, and other relevant attributes that allow us to process and analyze it effectively.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://forestreet.mintlify.site/_mintlify/api/og/v2?division=Events+Monitor\u0026amp;title=Get+an+Observation\u0026amp;description=%0A++Retrieves+a+single+observation+based+on+the+provided+observation+ID.%0A%0A++%3CInfo%3E%0A++**Subscription+Endpoint**%0A%0A++This+endpoint+has+a+special+subscription+requir\u0026amp;theme=acb3b42503ddba11d1ec590b\u0026amp;signature=4a17ae70c8fd8c08b4069f82a78ca379a9a835b1f320811fa2a8e9ef67f7ac00\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/forestreet/CQ9RrLPrT2waDRGc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Forestreet Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0f62fe\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.forestreet.com/api-reference/endpoints/events-monitor/get-an-observation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoints/events-monitor/get-an-observation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.forestreet.com/#organization\",\"name\":\"Forestreet Documentation\",\"url\":\"https://docs.forestreet.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/forestreet/bIVkQ4GpCRS8XyuT/logo/light.svg?fit=max\u0026auto=format\u0026n=bIVkQ4GpCRS8XyuT\u0026q=85\u0026s=bb2088ad5c6417fe9c8a2dab698d078b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.forestreet.com#website\",\"name\":\"Forestreet Documentation\",\"url\":\"https://docs.forestreet.com\",\"publisher\":{\"@id\":\"https://docs.forestreet.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.forestreet.com/api-reference/endpoints/events-monitor/get-an-observation#webpage\",\"url\":\"https://docs.forestreet.com/api-reference/endpoints/events-monitor/get-an-observation\",\"name\":\"Get an Observation\",\"description\":\"Retrieves a single observation based on the provided observation ID. Subscription Endpoint This endpoint has a special subscription requirement. Your API Key needs to be subscribed to this endpoint in order to access it; otherwise it will return a 403 Forbidden error. Please contact Forestreet support to get subscribed. An Observation is a piece of information or data point that has been collected and stored in our system. It serves as the foundational unit of information to join together as Events, and can represent various types of data such as news articles, social media posts, analyst reports, or any other relevant information that we want to track and analyze. Each observation contains metadata about its source, content, publication time, and other relevant attributes that allow us to process and analyze it effectively.\",\"dateModified\":\"2026-05-11T14:38:00.697Z\",\"isPartOf\":{\"@id\":\"https://docs.forestreet.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.forestreet.com/api-reference/endpoints/events-monitor/get-an-observation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.forestreet.com/api-reference/endpoints/events-monitor/get-an-observation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.forestreet.com/api-reference/endpoints/auth/sign-in\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Events Monitor\",\"item\":\"https://docs.forestreet.com/api-reference/endpoints/events-monitor/list-events\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get an Observation\",\"item\":\"https://docs.forestreet.com/api-reference/endpoints/events-monitor/get-an-observation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.forestreet.com/api-reference/endpoints/events-monitor/get-an-observation#apireference\",\"headline\":\"Get an Observation\",\"name\":\"Get an Observation\",\"description\":\"Retrieves a single observation based on the provided observation ID. Subscription Endpoint This endpoint has a special subscription requirement. Your API Key needs to be subscribed to this endpoint in order to access it; otherwise it will return a 403 Forbidden error. Please contact Forestreet support to get subscribed. An Observation is a piece of information or data point that has been collected and stored in our system. It serves as the foundational unit of information to join together as Events, and can represent various types of data such as news articles, social media posts, analyst reports, or any other relevant information that we want to track and analyze. Each observation contains metadata about its source, content, publication time, and other relevant attributes that allow us to process and analyze it effectively.\",\"url\":\"https://docs.forestreet.com/api-reference/endpoints/events-monitor/get-an-observation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.forestreet.com/api-reference/endpoints/events-monitor/get-an-observation#webpage\"},\"dateModified\":\"2026-05-11T14:38:00.697Z\",\"publisher\":{\"@id\":\"https://docs.forestreet.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.forestreet.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Forestreet Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Forestreet Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoints/events-monitor/get-an-observation.md","siteName":"Forestreet Documentation","nav":{"global":null,"versions":[{"version":"2.0","groups":[{"group":"Quick Start","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"}]},{"group":"Guides","pages":[{"title":"Discovery Workflow","href":"/api-reference/guides/platform-discovery"},{"title":"Export via API","href":"/api-reference/guides/export-api"},{"title":"iFrame Integration","href":"/api-reference/guides/iframe-integration"}]},{"group":"API Reference","pages":[{"group":"Authentication","icon":"key","pages":[{"openapi":"post /v2/auth/sign-in","title":"Sign in","href":"/api-reference/endpoints/auth/sign-in"},{"openapi":"post /v2/auth/sign-out","title":"Sign out","href":"/api-reference/endpoints/auth/sign-out"},{"openapi":"get /v2/auth/session","title":"Get session ID","href":"/api-reference/endpoints/auth/get-session-id"},{"openapi":"put /v2/auth/session","title":"Set Session Cookies","href":"/api-reference/endpoints/auth/set-session-cookies"}]},{"group":"Team Management","icon":"users","pages":[{"group":"Team Management","pages":[{"openapi":"get /v2/teams/{teamId}","title":"Get a team by ID","href":"/api-reference/endpoints/teams/get-a-team-by-id"},{"openapi":"post /v2/teams","title":"Create a team","href":"/api-reference/endpoints/teams/create-a-team"},{"openapi":"patch /v2/teams/{teamId}","title":"Edit a team","href":"/api-reference/endpoints/teams/edit-a-team"},{"openapi":"delete /v2/teams/{teamId}","title":"Delete a team","href":"/api-reference/endpoints/teams/delete-a-team"},{"openapi":"get /v2/teams","title":"Get current user's teams","href":"/api-reference/endpoints/teams/get-current-users-teams"}]},{"group":"User Operations","pages":[{"openapi":"get /v2/users/me","title":"About me","href":"/api-reference/endpoints/users/about-me"}]},{"group":"Export Endpoints","pages":[{"openapi":"get /v2/teams/{teamId}/endpoints","title":"Get team export endpoints","href":"/api-reference/endpoints/teams/get-team-export-endpoints"},{"openapi":"post /v2/teams/{teamId}/endpoints","title":"Get team export endpoints, advanced","href":"/api-reference/endpoints/teams/get-team-export-endpoints-advanced"},{"openapi":"put /v2/teams/{teamId}/endpoint/{endpointName}","title":"Register export endpoint for a team","href":"/api-reference/endpoints/teams/register-export-endpoint-for-a-team"},{"openapi":"patch /v2/teams/{teamId}/endpoint/{endpointName}","title":"Update export endpoint for a team","href":"/api-reference/endpoints/teams/update-export-endpoint-for-a-team"},{"openapi":"delete /v2/teams/{teamId}/endpoint/{endpointName}","title":"Delete export endpoint for a team","href":"/api-reference/endpoints/teams/delete-export-endpoint-for-a-team"}]}]},{"group":"Collection Management","icon":"folder","pages":[{"openapi":"get /v2/teams/{teamId}/collections","title":"Get team collections","href":"/api-reference/endpoints/teams/get-team-collections"},{"openapi":"post /v2/teams/{teamId}/collections","title":"Create a collection","href":"/api-reference/endpoints/teams/create-a-collection"}]},{"group":"Market Intelligence","icon":"magnifying-glass","pages":[{"group":"Market CRUD","pages":[{"openapi":"get /v2/collections/{collectionId}/markets","title":"Get markets","href":"/api-reference/endpoints/markets/get-markets"},{"openapi":"get /v2/markets/{marketId}","title":"Get a market","href":"/api-reference/endpoints/markets/get-a-market"},{"openapi":"delete /v2/markets/{marketId}","title":"Delete a market","href":"/api-reference/endpoints/markets/delete-a-market"},{"openapi":"patch /v2/markets/{marketId}","title":"Update a market","href":"/api-reference/endpoints/markets/update-a-market"},{"openapi":"post /v2/markets/{marketId}/move","title":"Move a market","href":"/api-reference/endpoints/markets/move-a-market"},{"openapi":"get /v2/markets/{marketId}/explorer/companies","title":"List market explorer companies","href":"/api-reference/endpoints/markets/list-market-explorer-companies"},{"openapi":"get /v2/markets/{marketId}/explorer/companies/filters","title":"Get market explorer filters","href":"/api-reference/endpoints/markets/get-market-explorer-filters"}]},{"group":"Discovery Process","pages":[{"openapi":"post /v2/discovery/search-criteria","title":"Generate search criteria","href":"/api-reference/endpoints/discovery/generate-search-criteria"},{"openapi":"post /v2/discovery/search-criteria/keywords","title":"Generate keywords for search","href":"/api-reference/endpoints/discovery/generate-keywords-for-search"},{"openapi":"post /v2/discovery/start","title":"Start discovery for new market","href":"/api-reference/endpoints/discovery/start-discovery-for-new-market"},{"openapi":"post /v2/discovery/{marketId}/start","title":"Start discovery for existing market","href":"/api-reference/endpoints/discovery/start-discovery-for-existing-market"},{"openapi":"get /v2/discovery/{marketId}/jobs","title":"Get job status","href":"/api-reference/endpoints/discovery/get-job-status"}]},{"group":"Company Review","pages":[{"openapi":"get /v2/discovery/{marketId}/search-criteria","title":"Get search criteria","href":"/api-reference/endpoints/discovery/get-search-criteria"},{"openapi":"get /v2/discovery/{marketId}/search-criteria/history","title":"Get search criteria history","href":"/api-reference/endpoints/discovery/get-search-criteria-history"},{"openapi":"patch /v2/discovery/{marketId}/companies/reviews","title":"Update company review status","href":"/api-reference/endpoints/discovery/update-company-review-status"},{"openapi":"post /v2/discovery/{marketId}/publish","title":"Publish a market","href":"/api-reference/endpoints/discovery/publish-a-market"}]},{"group":"Market Analysis","pages":[{"group":"Companies Data","pages":[{"openapi":"get /v2/markets/{marketId}/explorer/companies","title":"List market explorer companies","href":"/api-reference/endpoints/markets/list-market-explorer-companies"},{"openapi":"get /v2/markets/{marketId}/explorer/companies/filters","title":"Get market explorer filters","href":"/api-reference/endpoints/markets/get-market-explorer-filters"}]},{"group":"ESG","pages":[{"openapi":"post /v2/markets/{marketId}/esg","title":null,"href":"/api-reference/endpoints/markets/get-esg-data-for-a-market"},{"openapi":"post /v2/markets/{marketId}/esg/filters","title":null,"href":"/api-reference/endpoints/markets/get-esg-filters-for-a-market"},{"openapi":"get /v2/markets/{marketId}/companies/{domain}/esg","title":null,"href":"/api-reference/endpoints/markets/get-esg-data-for-a-company-in-a-market"}]}]}]},{"group":"Impact Intelligence","icon":"globe","pages":[{"openapi":"post /v2/impact/search","title":"Search companies","href":"/api-reference/endpoints/impact/search-companies"},{"openapi":"get /v2/impact/companies/{identifier}","title":"Get a company","href":"/api-reference/endpoints/impact/get-a-company"},{"openapi":"get /v2/impact/companies/{identifier}/news","title":"Get news for a company","href":"/api-reference/endpoints/impact/get-news-for-a-company"}]},{"group":"Supplier Dossier","icon":"briefcase","pages":[{"openapi":"post /v2/collections/{collectionId}/dossier/create","title":"Create a dossier","href":"/api-reference/endpoints/dossier/create-a-dossier"},{"openapi":"delete /v2/collections/{collectionId}/dossier/{agentId}","title":"Delete a dossier","href":"/api-reference/endpoints/dossier/delete-a-dossier"},{"openapi":"get /v2/collections/{collectionId}/dossier/{agentId}","title":"Get a dossier","href":"/api-reference/endpoints/dossier/get-a-dossier"},{"openapi":"post /v2/collections/{collectionId}/dossiers","title":"Get dossiers in collection","href":"/api-reference/endpoints/dossier/get-dossiers-in-collection"},{"openapi":"patch /v2/collections/{collectionId}/dossier/{agentId}","title":"Update a dossier","href":"/api-reference/endpoints/dossier/update-a-dossier"}]},{"group":"Events Monitor","icon":"bell","pages":[{"openapi":"get /v2/events-monitor/events","title":"List events","href":"/api-reference/endpoints/events-monitor/list-events"},{"openapi":"get /v2/events-monitor/event-groups","title":"List event groups","description":"\n Retrieves groups of events that refer to the same real-world occurrence, for every group\n updated in the last 24 hours. Each item in `data` is one group, given as the list of its\n events. The events have the same shape as the ones returned by List events.\n\n \u003cInfo>\n **Subscription Endpoint**\n\n This endpoint has a special subscription requirement. Your API Key needs to be\n subscribed to this endpoint in order to access it; otherwise it will return a 403\n Forbidden error. Please contact Forestreet support to get subscribed.\n \u003c/Info>\n\n Events built from proprietary data are kept separate from events built from public data,\n so the same occurrence can appear as several events. An event group links them together.\n Each event's `providers` field shows which data providers it was built from. A group may\n hold a single event when no other event was found to match it.\n\n Groups are sorted by when they were last updated, most recent first, and the events within\n a group by when they were created, oldest first. Unlike List events, the events in a group\n are not filtered by impact scores.\n ","href":"/api-reference/endpoints/events-monitor/list-event-groups"},{"openapi":"get /v2/events-monitor/observation/{observationId}","title":"Get an Observation","href":"/api-reference/endpoints/events-monitor/get-an-observation"}]},{"group":"Assets","icon":"image","pages":[{"openapi":"get /v2/assets/icons/{iconName}","title":"Get an iconographic symbol by name","description":"Attempts to retrieve an iconographic symbol by its name from the Noun Project API.\n \n This endpoint supports both JSON and PNG responses.\n\n If the icon is not found and a PNG response is requested, it will return a fallback icon in form of\n a magnifying glass.","href":"/api-reference/endpoints/assets/get-an-iconographic-symbol-by-name"},{"openapi":"get /v2/assets/logos/{domain}","title":"Get a company logo by domain","href":"/api-reference/endpoints/assets/get-a-company-logo-by-domain"}]},{"group":"Public","icon":"people","pages":[{"openapi":"get /v2/public/assets/logos/{domain}","title":"Retrieve cached company logo by domain (public)","href":"/api-reference/endpoints/public/retrieve-cached-company-logo-by-domain-public"}]}]},{"group":"UI Components","pages":[{"title":"About UI Components","href":"/api-reference/ui-components/index"},{"title":"Feature Map","href":"/api-reference/ui-components/feature-map"},{"title":"Topic Mosaic","href":"/api-reference/ui-components/topic-mosaic"},{"title":"Momentum Score","href":"/api-reference/ui-components/momentum-score"},{"title":"Supplier Dossier","href":"/api-reference/ui-components/supplier-dossier"}]}]},{"version":"1.0 (Deprecated)","pages":[{"title":"1.0 (Deprecated)","href":"/api-reference/deprecated/v1"}]}]},"basePath":"","title":"Get an Observation - Forestreet Documentation","buildId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","deploymentId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CDiBsYGW.js","utils-KF9rPlmF.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C26urKTX.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BdjmJAC1.js","snippetPresets-3IpDBjt3.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-D4x_2vvo.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BIWdc5Pa.js","shallow-LQqfiMNd.js","getApiPlaygroundDisplay-DryzlOZG.js","CodeSnippet-tcJujU4r.js","CodeSnippets-BHp0nVLL.js","Page-1CZdsdAn.js","getPastedJson-DU-1ayUv.js","icon-CZK2hPr4.js","MethodPill-DOaqmTFC.js","DuplicateIcon-B5-nUxxl.js","createIcon-CDP_U77G.js","DynamicMarkdown-GHvayGOn.js","SectionHeading-BYvpkmUD.js","axios-vUo_bRtp.js","Markdown-uxhlayGT.js","clsx-B35qUV0p.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BvrGG8gU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CAf0yVYe.js"]}