Get one published Insight

Retrieve one published Middleman Insight and its evidence register by slug.

GET https://middlemantechnologies.com/api/v1/insights/{slug}

Get one published Insight

cURL

curl --request GET \
  --url https://middlemantechnologies.com/api/v1/insights/{slug}

200

{
  "data": {
    "slug": "<string>",
    "title": "<string>",
    "dek": "<string>",
    "category": "<string>",
    "publishedAt": "2023-12-25",
    "updatedAt": "2023-12-25",
    "readingMinutes": 2,
    "proof": "<string>",
    "status": "published",
    "author": "<string>",
    "featured": true,
    "blocks": [
      {
        "type": "paragraph",
        "text": "<string>"
      }
    ],
    "sources": [
      {
        "label": "<string>",
        "url": "<string>",
        "evidenceDate": "2023-12-25",
        "authority": "<string>"
      }
    ],
    "url": "<string>"
  }
}

Call the list endpoint first when you do not already have an exact slug.

Path Parameters

slug · string · required

Exact lowercase, hyphenated slug returned by the list endpoint.

Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

Response

200

application/json

Published Insight

data · object · required

Hide child attributes

data. slug · string · required

data. title · string · required

data. dek · string · required

data. category · string · required

data. publishedAt · string<date> · required

data. updatedAt · string<date> · required

data. readingMinutes · integer · required

Required range: x >= 1

data. proof · string · required

data. status · any · required

data. author · string · required

data. featured · boolean · required

data. blocks · object[] · required

Option 1

Option 2

Option 3

Hide child attributes

data.blocks. type · enum<string> · required

Available options: paragraph, heading

data.blocks. text · string · required

data. sources · object[] · required

Hide child attributes

data.sources. label · string · required

data.sources. url · string<uri> · required

data.sources. evidenceDate · string<date> · required

data.sources. authority · string · required

data. url · string<uri> · required