Retrieve a data source on a data feed

GET

data_feeds

{data_feed_friendly_id}

sources

{source_friendly_id}

Get a data source on a data feed

curl --request GET \
  --url https://app.gomangrove.com/api/v1/data_feeds/{data_feed_friendly_id}/sources/{source_friendly_id} \
  --header 'Authorization: <api-key>'

import requests

url = "https://app.gomangrove.com/api/v1/data_feeds/{data_feed_friendly_id}/sources/{source_friendly_id}"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://app.gomangrove.com/api/v1/data_feeds/{data_feed_friendly_id}/sources/{source_friendly_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.gomangrove.com/api/v1/data_feeds/{data_feed_friendly_id}/sources/{source_friendly_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.gomangrove.com/api/v1/data_feeds/{data_feed_friendly_id}/sources/{source_friendly_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.gomangrove.com/api/v1/data_feeds/{data_feed_friendly_id}/sources/{source_friendly_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "dsrc_aBcD1234eFgH5678",
  "name": "Warehouse readings",
  "source_type": "sql",
  "description": "<string>",
  "config": {},
  "state": {
    "cursor_value": "2026-01-02T00:00:00Z"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

Path Parameters

data_feed_friendly_id

string

required

The data feed's friendly ID (e.g. datafd_aBcD1234eFgH5678).

source_friendly_id

string

required

The source's friendly ID (e.g. dsrc_aBcD1234eFgH5678).

Response

The requested source.

A source attached to a data feed.

string

The source's friendly ID.

Example:

"dsrc_aBcD1234eFgH5678"

name

string

Example:

"Warehouse readings"

source_type

enum<string>

Available options:

endpoint,

ui_upload,

sql,

api

Example:

"sql"

description

string | null

config

object

The source's stored config, with the keys described for the request body. Scalar values are returned as strings, so daily_fetch reads "true" and a port "1433"; objects and arrays (headers, query, auth, poll, success_when) are returned as JSON. Credentials never appear here, but values typed directly into headers or query are stored and returned as entered.

Show child attributes

state

object

Fetch progress, returned as stored. A {{cursor_value}} source keeps cursor_value (the last row's cursor) and, for SQL, pre_query_result; a window source keeps window_start, window_finish, cursor_value (the next window's start) and capped: true when max_window_seconds cut the last window short. Empty for receive-based sources.

Example:

{ "cursor_value": "2026-01-02T00:00:00Z" }

created_at

string<date-time>

updated_at

string<date-time>

Get a data source on a data feed

curl --request GET \
  --url https://app.gomangrove.com/api/v1/data_feeds/{data_feed_friendly_id}/sources/{source_friendly_id} \
  --header 'Authorization: <api-key>'

import requests

url = "https://app.gomangrove.com/api/v1/data_feeds/{data_feed_friendly_id}/sources/{source_friendly_id}"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://app.gomangrove.com/api/v1/data_feeds/{data_feed_friendly_id}/sources/{source_friendly_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.gomangrove.com/api/v1/data_feeds/{data_feed_friendly_id}/sources/{source_friendly_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.gomangrove.com/api/v1/data_feeds/{data_feed_friendly_id}/sources/{source_friendly_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.gomangrove.com/api/v1/data_feeds/{data_feed_friendly_id}/sources/{source_friendly_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "dsrc_aBcD1234eFgH5678",
  "name": "Warehouse readings",
  "source_type": "sql",
  "description": "<string>",
  "config": {},
  "state": {
    "cursor_value": "2026-01-02T00:00:00Z"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Getting Started

API Cookbooks

Production Data

Accounting and Reporting

Credit Inventory Management

Account Admin

Authorizations

Path Parameters

Response