Lightweight Python client for the Accela API.
uv add git+https://github.com/atwalsh/accelaThis SDK supports creating a token with the Password Credential Login flow. To make an access token, you'll need:
- An Accela developer app
- A citizen account with an Accela agency
from accela import get_access_token, AccelaClient
# Get an access token
token = get_access_token(
client_id="your_client_id",
client_secret="your_client_secret",
username="your_username",
password="your_password",
agency_name="AGENCY",
environment="PROD",
grant_type="password",
scope="records",
id_provider="citizen"
)
# Create a client
client = AccelaClient(
access_token=token.access_token,
agency="AGENCY",
environment="PROD"
)# List records
records = client.records.list(limit=10)
# Iterate through records
for record in records:
print(f"Record ID: {record.id}, Type: {record.type}")
# Paginate through all records
for record in records.auto_paging_iter():
print(f"Record ID: {record.id}, Type: {record.type}")
# Get a specific record
record = client.records.retrieve("RECORD-123")# Get addresses for a record
addresses = client.record_addresses.list("RECORD-123")
# Iterate through addresses
for address in addresses:
...# List documents for a record
documents = client.record_documents.list("RECORD-123")
# Iterate through documents
for doc in documents:
print(f"Document: {doc.file_name} ({doc.size} bytes)")
print(f"Type: {doc.type}")
# Paginate through all documents
for doc in documents.auto_paging_iter():
print(f"Document: {doc.file_name}")
# Alternative nested access
documents = client.records.documents.list("RECORD-123")# Get document metadata
doc = client.documents.retrieve("12345")
print(f"File: {doc.file_name}")
print(f"Category: {doc.category['text'] if doc.category else 'N/A'}")
# Download in chunks
response = client.documents.download("12345")
with open(doc.file_name, "wb") as f:
for chunk in response.iter_content(chunk_size=8192):
f.write(chunk)
# Download directly
response = client.documents.download("12345")
with open(doc.file_name, "wb") as f:
f.write(response.content)