Motivation MoneyAPI 参考Employees
List all employees and contractors in the organization
Returns paginated employee records with salary, wallet, and verification data.
Requires employees:read scope.
Authorization
apiKey AuthorizationBearer <token>
API key: Authorization: Bearer mpk_live_<key>
In: header
Query Parameters
status?string
- ACTIVE: Can receive payouts and access portal.
- PENDING: Invited but hasn't completed onboarding.
- INACTIVE: Deactivated. Excluded from payroll runs.
Value in
"ACTIVE" | "PENDING" | "INACTIVE"employment_type?string
- FTE: Full-time employee. Fixed monthly salary.
- CONTRACTOR: Independent contractor. Variable payments.
- CONSULTANT: External consultant.
Value in
"FTE" | "CONTRACTOR" | "CONSULTANT"role?string
- ADMIN: Full access to org settings, team, and payroll.
- OWNER: Same as Admin, plus designated Safe signer.
- ACCOUNTANT: Can create/review payroll runs and view audit logs.
- EMPLOYEE: Self-service portal only.
Value in
"ADMIN" | "OWNER" | "ACCOUNTANT" | "EMPLOYEE"wallet_verified?boolean
Filter by wallet verification status
search?string
Search by name or email (case-insensitive substring)
limit?integer
Max results per page
Default
25Range
1 <= value <= 200offset?integer
Number of results to skip
Default
0Range
0 <= valueResponse Body
application/json
curl -X GET "https://motivation-money.vercel.app/api/v1/employees?search=alice"{
"data": [
{
"id": "usr_emp456",
"name": "Alice Chen",
"email": "alice@acme.com",
"role": "ADMIN",
"status": "ACTIVE",
"employment_type": "FTE",
"salary_usd_cents": 850000,
"payment_schedule": "MONTHLY_1ST",
"stablecoin": "USDC",
"network": "ETHEREUM",
"wallet_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD38",
"wallet_verified": true,
"contract_start_date": "2025-06-01",
"contract_end_date": "2019-08-24",
"avatar_url": "http://example.com",
"invited_by_user_id": "usr_abc123",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"pagination": {
"total": 142,
"limit": 25,
"offset": 0,
"has_more": true
},
"api_version": "2026-03-01",
"request_id": "req_f1a2b3c4"
}