Skip to main content
GET
List deals

Authorizations

Authorization
string
header
required

API key from Settings > Developer. Format: alva_sk_...

Query Parameters

page
integer
default:1

Page number

Required range: x >= 1
limit
integer
default:25

Items per page (max 100)

Required range: 1 <= x <= 100
sort
string

Sort by field:direction. Fields: name, value, stage, createdAt, updatedAt, expectedCloseDate. Direction: asc or desc. Example: createdAt:desc

Search by deal name

stage
enum<string>

Filter by pipeline stage

Available options:
discovery,
qualification,
proposal,
negotiation,
closed_won,
closed_lost
companyId
string<uuid>

Filter by company ID

ownerId
string<uuid>

Filter by deal owner (user ID)

methodology
enum<string>

Filter by methodology

Available options:
meddpicc,
bant,
spiced

Response

List of deals

data
object[]
pagination
object
resource
string