PipeRiv

  • Login
  • Register
    •

    Pipelines

    The pipelines endpoint is private and requires Premium API access.

    GET /pipelines

    Private endpoint. Provides the list of pipelines.



    Result Values

    id: integer
    The PipeRiv id and primary key in the database. This value will be unique.

    name: short string
    The name of the pipeline.

    slug: short string
    A short, lowercase, alphanumeric, dashed, non-spaced, readable identifier.

    url: short string
    The URL of the informational postings for the pipeline.

    tsp_name: short string
    The Transporation Service Provider (TSP) name for the pipeline.

    tsp_id: short string
    The Transporation Service Provider (TSP) id for the pipeline.

    piperiv_created_at: datetime
    The date and time the pipeline was added to the PipeRiv system using the UTC timezone.

    piperiv_updated_at: datetime
    The date and time the pipeline was updated on the PipeRiv system using the UTC timezone.



    Endpoint Example

    Below is a live example that can be copy and pasted.

    curl https://www.piperiv.com/api/v1/ip/pipelines -u "demo:pr_api_live_01234demo56789_key"

    Below is the expected result from that cURL call:

    {
  "status": "success",
  "messages": [],
  "meta": {
    "total_results": 94
  },
  "data": [
    {
      "id": 42,
      "name": "Algonquin Gas Transmission",
      "slug": "algonquin",
      "url": "https://infopost.enbridge.com/infopost/AGHome.asp?Pipe=AG",
      "tsp_name": "Algonquin Gas Transmission, LLC",
      "tsp_id": "006951446",
      "piperiv_created_at": "2024-10-09 22:48:22",
      "piperiv_updated_at": "2024-10-09 22:48:22"
    },
    {
      "id": 87,
      "name": "Alliance Pipeline",
      "slug": "alliance",
      "url": "http://ips.alliance-pipeline.com/Ips/MainPage.aspx?siteId=1",
      "tsp_name": "Alliance Pipeline L.P.",
      "tsp_id": "809787513",
      "piperiv_created_at": "2024-10-09 22:48:25",
      "piperiv_updated_at": "2024-10-09 22:48:25"
    },
    ...
    {
      "id": 24,
      "name": "Young Gas Storage",
      "slug": "young",
      "url": "https://pipeportal.kindermorgan.com/PortalUI/DefaultKM.aspx?TSP=YGS",
      "tsp_name": "YOUNG GAS STORAGE COMPANY",
      "tsp_id": "876708744",
      "piperiv_created_at": "2024-10-09 22:48:22",
      "piperiv_updated_at": "2024-10-09 22:48:22"
    }
  ]
}

    Error