API reference · Your application
List your allowed addresses
GET
/v1/application/networksGET /v1/application/networks lists the addresses your application may call from, who added each one, and how many more you may add. Staging only — testing endpoints, not available in production. Production answers 404 resource_not_found.
PermissionNone
AuthenticationSigned read
Anis’s answerNot signed
Staff-set limits it counts towardAll requests
.NET SDK
Permanently excluded from all SDKs; send a signed HTTP request.- No particular permission is required, but your application must have at least one effective permission. The first allowed address still comes from Anis when your application is set up. Call from an address already on the list, using a signed request and an active key.
- The list may take a few seconds to show a change. The add and remove answers include the current list.
Request
Signed with your key. No body, no nonce.
Headers: Signature-Input, Signature, X-Anis-Date. The SDKs set all of them for you.
Body: none.
Responses
| Status | Meaning | Body |
|---|---|---|
| 200 | Success. | ApplicationNetworks |
| 400 | Refused: the signed request is badly built. | Problem |
| 401 | Refused: not authenticated. | Problem |
| 403 | Refused: not allowed. | Problem |
| 404 | Refused: not found, or not yours. | Problem |
| 429 | Refused: a limit was reached. | Problem |
| 503 | No decision: a dependency was unavailable. | Problem |
The answers of this call are not signed — no Signature or Signature-Input header, success or refusal. There is nothing to verify; TLS protects them. Content-Digest and X-Request-Id are still present.
Refusals
A refusal of this call is a problem without a signature. Branch on its code; each links to what it means and what to do.
| Error | Code | Status |
|---|---|---|
| Invalid credentials | invalid_credentials | 401 |
| Malformed signed request | malformed_signed_request | 400 |
| Insufficient scope | insufficient_scope | 403 |
| Source address not allowed | source_ip_not_allowed | 403 |
| Rate limited | rate_limited | 429 |
| Not found | resource_not_found | 404 |
| Service unavailable | dependency_unavailable | 503 |
| Request timeout | request_timeout | 504 |
| Internal error | internal_error | 500 |
Types
ApplicationNetworks
| Field | Type | Notes |
|---|---|---|
networksalways present | list of ApplicationNetwork | Every address the application may call from, in canonical order. The first address is supplied by Anis at onboarding. |
partnerNetworksRemainingalways present | integer | How many more addresses your application may add, up to 10 Partner-added addresses. |
ApplicationNetwork
| Field | Type | Notes |
|---|---|---|
cidralways present | string | An address the application may call from, in CIDR form. Addresses added by a Partner are stored as /32 (IPv4) or /128 (IPv6). |
addedByalways present | string | anis if Anis added the address; partner if your application added it. You can remove only addresses marked partner. Values: anis, partner |