> ## Documentation Index > Fetch the complete documentation index at: https://docs.rangler.co/llms.txt > Use this file to discover all available pages before exploring further. # List News Development Cards ## OpenAPI ````yaml /openapi.json get /v1/news/developments openapi: 3.1.0 info: title: Rangler API version: 1.0.0 description: >- Customer-facing Rangler API for companies, standardized financials, filings, funds, market data, events, and webhooks. servers: - url: https://api.rangler.co description: Live - url: https://sandbox-api.rangler.co description: Sandbox security: [] tags: - name: Analyst estimates description: Consensus forecasts, revisions, contributor accuracy, and source evidence. - name: Analyst recommendations description: Analyst ratings, target-price views, and company recommendation history. - name: Calendar description: Company events and calendar exports. - name: Companies description: >- Company lookup, issuer details, dividends, daily trades, meeting media, and mentions. - name: Events description: >- Read earlier events and check for missed deliveries across the market, a company, or a fund. - name: Financials description: >- Standardized financial statements, reported tables, ratios, and links to filing sources. - name: Filings description: Filings, board changes, insider dealings, and extracted filing mentions. - name: Funds description: Fund directories, disclosures, snapshots, holdings, and performance data. - name: Markets description: Market directories and regular-session clock data. - name: News description: Company news developments and company-filtered news search. paths: /v1/news/developments: get: tags: - News summary: List News Development Cards operationId: get_v1_news_developments parameters: - name: market_code in: query required: false schema: anyOf: - type: string - type: 'null' description: Optional market venue code, e.g. NGX or NASD title: Market Code description: Optional market venue code, e.g. NGX or NASD - name: q in: query required: false schema: anyOf: - type: string maxLength: 160 minLength: 1 - type: 'null' title: Q - name: company_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' title: Company Id - name: ticker in: query required: false schema: anyOf: - type: string maxLength: 32 - type: 'null' title: Ticker - name: sector in: query required: false schema: anyOf: - type: string maxLength: 120 - type: 'null' title: Sector - name: period in: query required: false schema: type: string maxLength: 16 default: 7d title: Period - name: scope in: query required: false schema: enum: - all - tracked type: string default: all title: Scope - name: limit in: query required: false schema: type: integer maximum: 50 minimum: 1 default: 20 title: Limit - name: cursor in: query required: false schema: anyOf: - type: string maxLength: 512 - type: 'null' title: Cursor - name: country_code in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by ISO 3166-1 alpha-2 market country code title: Country Code description: Filter by ISO 3166-1 alpha-2 market country code responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/NewsDevelopmentPage' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: default: value: error: type: unauthorized code: unauthorized message: Authentication required. request_id: 28fa6152-7081-492e-8a7e-00beb237b689 '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: default: value: error: type: forbidden code: forbidden message: Paid access is required. request_id: 5c253b3e-778e-4a58-aaf8-07cb21e03563 '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: default: value: error: type: validation_error code: validation_error message: Request validation failed request_id: c5964dca-d290-4465-a3dc-f92d42aa9b17 details: - type: missing loc: - query - ticker msg: Field required input: null '429': description: Too Many Requests content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: default: value: error: type: rate_limit_exceeded code: rate_limit_exceeded message: Rate limit exceeded request_id: cc4d369a-2c69-4ee2-909e-985ea35d14a9 '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: default: value: error: type: internal_server_error code: internal_server_error message: Internal Server Error request_id: 70b63aba-b8a3-41c2-bb0c-fbe67d84d37d security: - RanglerApiKey: [] components: schemas: NewsDevelopmentPage: properties: data: items: $ref: '#/components/schemas/NewsDevelopmentRead' type: array title: Data next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor type: object required: - data title: NewsDevelopmentPage ErrorEnvelope: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorObject' NewsDevelopmentRead: properties: id: type: string format: uuid title: Id headline: type: string title: Headline summary: type: string title: Summary why_it_matters: anyOf: - type: string - type: 'null' title: Why It Matters status: type: string title: Status confidence: type: number maximum: 1 minimum: 0 title: Confidence source_count: type: integer title: Source Count first_published_at: anyOf: - type: string format: date-time - type: 'null' title: First Published At last_published_at: anyOf: - type: string format: date-time - type: 'null' title: Last Published At generated_at: anyOf: - type: string format: date-time - type: 'null' title: Generated At primary_company: anyOf: - $ref: '#/components/schemas/CompanyRead' - type: 'null' companies: items: $ref: '#/components/schemas/CompanyRead' type: array title: Companies sources: items: $ref: '#/components/schemas/NewsDevelopmentSourceRead' type: array title: Sources price_context: anyOf: - $ref: '#/components/schemas/NewsDevelopmentPriceContextRead' - type: 'null' type: object required: - id - headline - summary - status - confidence - source_count title: NewsDevelopmentRead ErrorObject: type: object required: - type - code - message - request_id properties: type: type: string code: type: string message: type: string request_id: type: string details: anyOf: - additionalProperties: true type: object - type: array items: additionalProperties: true type: object - type: 'null' CompanyRead: properties: id: type: string format: uuid title: Id name: type: string title: Name ticker: type: string title: Ticker isin: anyOf: - type: string - type: 'null' title: Isin sector: anyOf: - type: string - type: 'null' title: Sector is_public: anyOf: - type: boolean - type: 'null' title: Is Public exchange: anyOf: - type: string - type: 'null' title: Exchange country_code: type: string title: Country Code default: NG market_classification: anyOf: - type: string - type: 'null' title: Market Classification index_memberships: anyOf: - items: type: string type: array - type: 'null' title: Index Memberships ir_url: anyOf: - type: string - type: 'null' title: Ir Url website: anyOf: - type: string - type: 'null' title: Website logo_url: anyOf: - type: string - type: 'null' title: Logo Url created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At type: object required: - id - name - ticker title: CompanyRead NewsDevelopmentSourceRead: properties: article_id: type: string format: uuid title: Article Id company_id: anyOf: - type: string format: uuid - type: 'null' title: Company Id title: type: string title: Title url: type: string title: Url publisher: anyOf: - type: string - type: 'null' title: Publisher publisher_domain: anyOf: - type: string - type: 'null' title: Publisher Domain favicon_domain: anyOf: - type: string - type: 'null' title: Favicon Domain published_at: anyOf: - type: string format: date-time - type: 'null' title: Published At description: anyOf: - type: string - type: 'null' title: Description excerpt: anyOf: - type: string - type: 'null' title: Excerpt type: object required: - article_id - title - url title: NewsDevelopmentSourceRead NewsDevelopmentPriceContextRead: properties: price: type: number title: Price currency: anyOf: - type: string - type: 'null' title: Currency as_of: type: string format: date title: As Of net_change: anyOf: - type: number - type: 'null' title: Net Change percentage_change: anyOf: - type: number - type: 'null' title: Percentage Change description: Fractional price change; 0.05 means 5%. type: object required: - price - as_of title: NewsDevelopmentPriceContextRead securitySchemes: RanglerApiKey: type: apiKey in: header name: X-API-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.