LogoLogo
GoodAccess WebsiteRequest Free TrialDownload App
  • Getting Started
    • 1. What is GoodAccess?
    • 2. Architecture Overview
    • 3. Sign up for Free Trial
    • 4. Download App & Connect
  • 🖥️Configuration guides
    • Features
      • Zero Trust Access Control
        • Access Cards
        • Device Posture Check
        • Device Approval
        • Geo Restrictions
      • API Integration
        • API Reference
          • Members
          • Groups
          • Systems
          • Access Cards
          • Relations
          • Gateways
          • Logs
        • Acronis Integration
      • SIEM Integration
      • SSO/SCIM
        • Auth0
        • Cisco Duo
        • Google Workspace
        • JumpCloud
        • Microsoft Entra ID
        • Okta
        • OneLogin
        • Ping Identity
        • Universal (SAML)
      • MFA
      • Passkeys
      • MSI deployment
      • Threat Blocker
      • Custom Domain Blocking
      • DNS Management
      • Split Tunneling
      • Port Forwarding
    • Branch Connector
      • Cisco
      • Cisco Meraki
      • FortiGate
      • MikroTik
      • SonicWall
      • UniFi USG
      • Zyxel Nebula Control Center
      • Other supported routers and firewalls
    • Cloud Connector
      • AWS
      • Google Cloud
      • Microsoft Azure
      • Other Public Cloud providers
    • IP whitelisting
      • APACHE Web Server
      • AWS VPC
      • Azure (Office 365)
      • Google Cloud
      • Google Workspace
      • Magento
      • Microsoft IIS
      • NGINX
        • Domain
        • Subdomain
        • URL
      • OpenCart
      • PHP
      • PHPMyAdmin
      • Pipedrive
      • SalesForce
      • SSH server
      • WordPress
      • Zoho CRM
    • Linux
      • DEB repository
      • RPM repository
      • Manual installation
      • Linux Troubleshooting
  • 🆘FAQ & Troubleshooting
    • FAQ
      • Business
      • Technical
    • Troubleshooting
  • 📓Product Changelog
    • Windows
    • macOS
Powered by GitBook
On this page

Was this helpful?

  1. Configuration guides
  2. Features
  3. API Integration
  4. API Reference

Access Cards

Create custom Access Cards granting access to selected Systems and assign it to your Team Members.

PreviousSystemsNextRelations

Last updated 4 months ago

Was this helpful?

🖥️
Relations

Fetch All access cards

get
Authorizations
Responses
200
OK
application/json
Responseobject
get
GET /api/v1/access-cards HTTP/1.1
Host: integration.goodaccess.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

[
  {
    "id": "8e4a413c-7f7b-4925-9b9b-e22c3f65f2a0",
    "name": "GoodAccess Access Card",
    "description": "Access Card created from GoodAccess Contronl Panel for internal systems",
    "members": [
      {
        "id": "57f25acc-7eb8-494b-bb64-7671b5726e2d",
        "created_at": "2024-05-07 10:48:44",
        "team_id": "162b441d-6c72-4597-92ea-185af41078cb",
        "avatar_url": "router.png",
        "name": "GoodAccess User",
        "username": "user@goodaccess.com",
        "is_user_blocked": true,
        "is_mfa_active": false
      }
    ],
    "systems": [
      {
        "id": "69f25acc-7eb8-494b-bb64-7671b5726e2d",
        "created_at": "2024-08-15 10:48:44",
        "name": "GoodAccess System",
        "is_valid": true,
        "port": "8080",
        "host": "goodaccess.com",
        "uri": "https://goodaccess.com"
      }
    ]
  }
]

Fetch Access Card by its ID

get
Authorizations
Path parameters
accessCardIdstringRequired

ID of access card

Responses
200
OK
application/json
Responseobject
404
Not Found
application/json
get
GET /api/v1/access-card/{accessCardId} HTTP/1.1
Host: integration.goodaccess.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "id": "8e4a413c-7f7b-4925-9b9b-e22c3f65f2a0",
  "name": "GoodAccess Access Card",
  "description": "Access Card created from GoodAccess Contronl Panel for internal systems",
  "members": [
    {
      "id": "57f25acc-7eb8-494b-bb64-7671b5726e2d",
      "created_at": "2024-05-07 10:48:44",
      "team_id": "162b441d-6c72-4597-92ea-185af41078cb",
      "avatar_url": "router.png",
      "name": "GoodAccess User",
      "username": "user@goodaccess.com",
      "is_user_blocked": true,
      "is_mfa_active": false
    }
  ],
  "systems": [
    {
      "id": "69f25acc-7eb8-494b-bb64-7671b5726e2d",
      "created_at": "2024-08-15 10:48:44",
      "name": "GoodAccess System",
      "is_valid": true,
      "port": "8080",
      "host": "goodaccess.com",
      "uri": "https://goodaccess.com"
    }
  ]
}

Remove Access Card by its ID

delete
Authorizations
Path parameters
accessCardIdstringRequired

ID of access card

Responses
200
OK
application/json
Responseobject
404
Not Found
application/json
delete
DELETE /api/v1/access-card/{accessCardId} HTTP/1.1
Host: integration.goodaccess.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "message": "User with id <member-id> has been removed."
}
  • GETFetch All access cards
  • GETFetch Access Card by its ID
  • POSTCreate Access Card
  • PUTUpdate Access Card by its ID
  • DELETERemove Access Card by its ID
  • Relations

Create Access Card

post
Authorizations
Body
objectOptionalExample: {"name":"Example GoodAccess Access Card","description":"Description"}
Responses
200
OK
application/json
Responseobject
409
Conflict
application/json
post
POST /api/v1/access-card HTTP/1.1
Host: integration.goodaccess.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 69

{
  "name": "Example GoodAccess Access Card",
  "description": "Description"
}
{
  "created_id": "4514960a-2b6d-46a2-9c22-c02cc727abb7",
  "message": "Access card created successfully"
}

Update Access Card by its ID

put
Authorizations
Path parameters
accessCardIdstringRequired

ID of access card

Body
objectOptionalExample: {"name":"GoodAccess Access Card","description":"Description"}
Responses
200
OK
application/json
Responseobject
404
Not Found
application/json
409
Conflict
application/json
put
PUT /api/v1/access-card/{accessCardId} HTTP/1.1
Host: integration.goodaccess.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "name": "GoodAccess Access Card",
  "description": "Description"
}
{
  "status": 200,
  "message": "Access card updated successfully"
}