Retrieve goal analytics

api-referenceGET

GEThttps://analytics.flowsery.com/analytics/api/v1/goals

Fetch analytics data segmented by custom goals. Filter parameters narrow which visitors' completions are counted; limit and offset page through the goal list.

Bearer Token (workspace token or website API key)

Workspace Tokens Need a Website Selector

Workspace API tokens can access every website in the workspace. Pass either <code>websiteId</code> or <code>domain</code> so Flowsery knows which website to query or mutate. Website API keys are already scoped to one website, so the selector can be omitted.

Website Selector

Parameter	Type	Description
`websiteId`	`string`	Website ID to use with a workspace API token. Omit when authenticating with a website API key.
`domain`	`string`	Website domain to use with a workspace API token when websiteId is not provided. Omit when authenticating with a website API key.

Optional Parameters

Parameter	Type	Description
`startAt`	`string`	ISO 8601 start date/time. Defaults to the last 30 days when omitted.
`endAt`	`string`	ISO 8601 end date/time. Defaults to now when omitted.
`timezone`	`string`	Timezone for aggregation (e.g., UTC, America/New_York). Falls back to your site's configured timezone.
`limit`	`number`	Maximum rows to return (1-1000, default: 100).
`offset`	`number`	Rows to skip for pagination (min 0, default: 0).

Filter Parameters

Parameter	Type	Description
`filter_country`	`string`	Country name as returned by /countries, e.g. United States. Use \| for several values, ! to exclude and ~ to match part of the value.
`filter_region`	`string`	Region or state name as returned by /regions, e.g. California.
`filter_city`	`string`	City name.
`filter_device`	`string`	Device type: Desktop, Mobile or Tablet. Values are case-sensitive.
`filter_browser`	`string`	Browser name. Safari includes Mobile Safari automatically.
`filter_os`	`string`	Operating system.
`filter_referrer`	`string`	Referrer as returned by /referrers: a source name such as Google for recognized sites, otherwise the domain.
`filter_ref`	`string`	The ref URL parameter.
`filter_source`	`string`	The source URL parameter.
`filter_via`	`string`	The via URL parameter.
`filter_utm_source`	`string`	UTM source.
`filter_utm_medium`	`string`	UTM medium.
`filter_utm_campaign`	`string`	UTM campaign.
`filter_utm_term`	`string`	UTM term.
`filter_utm_content`	`string`	UTM content.
`filter_page`	`string`	Page path.
`filter_entry_page`	`string`	Entry page path.
`filter_hostname`	`string`	Hostname/domain.
`filter_channel`	`string`	Marketing channel.
`filter_goal`	`string`	Goal name.

Example Request (Curl)

curl --request GET \
  --url https://analytics.flowsery.com/analytics/api/v1/goals \
  --header 'Authorization: Bearer <api-key>'

200

{
  "status": "success",
  "data": [
    {
      "id": "goal_123",
      "createdAt": "2026-04-01T10:15:00.000Z",
      "updatedAt": "2026-04-14T08:30:00.000Z",
      "name": "newsletter_signup",
      "description": null,
      "isServer": false,
      "completions": 49730,
      "visitors": 49730
    },
    {
      "id": "goal_124",
      "createdAt": "2026-04-02T09:00:00.000Z",
      "updatedAt": "2026-04-14T08:30:00.000Z",
      "name": "payment",
      "description": "Tracked from the backend",
      "isServer": true,
      "completions": 35100,
      "visitors": 35100
    }
  ],
  "pagination": {
    "limit": 5,
    "offset": 0,
    "total": 48
  }
}